gdi+初始化不能仅全局调用一次，因多线程下需按线程粒度管理：每个线程首次使用gdi+时调用gdiplusstartup，退出时配对调用gdiplusshutdown；否则未清理线程再创建gdi+对象易致崩溃。
为什么GDI+初始化不能只靠全局GdiplusStartup
直接在main或DllMain里调用GdiplusStartup再不管，是常见错误。GDI+要求每个线程若使用GDI+对象（如GpGraphics、GpBitmap），必须先调用GdiplusStartup，且每个成功启动的调用必须配对GdiplusShutdown。多线程下，若仅全局启动一次，某线程提前退出时未清理，后续该线程再创建GDI+对象可能崩溃——错误信息通常是Access violation reading location 0x00000000或Invalid parameter passed to GDI+。
RAII封装的关键：按线程粒度管理GdiplusStartupInput
RAII不是简单包个GdiplusStartup/GdiplusShutdown就行。核心是：每个线程首次使用GDI+时启动，线程退出时自动关闭。需用线程局部存储（TLS）或thread_local（C++11起）保存启动令牌ULONG_PTR。
-
thread_local变量必须声明为静态，否则每次构造都重置 -
GdiplusStartupInput结构体中NotificationHook字段必须设为0，否则GDI+尝试挂钩消息循环，引发未定义行为 - 构造函数内调用
GdiplusStartup失败时，应抛异常或设标志位，避免静默失败后继续使用GDI+导致崩溃
示例：
class GdiplusScope {
static thread_local ULONG_PTR g_token;
static thread_local bool g_started;
public:
GdiplusScope() {
if (!g_started) {
GdiplusStartupInput input;
input.GdiplusVersion = 1;
input.DebugEventCallback = nullptr;
input.NotificationHook = 0; // 关键！不设为0会出问题
input.NotificationUnhook = 0;
if (GdiplusStartup(&g_token, &input, nullptr) != Ok) {
throw std::runtime_error("GdiplusStartup failed");
}
g_started = true;
}
}
~GdiplusScope() {
if (g_started) {
GdiplusShutdown(g_token);
g_started = false;
}
}
};
thread_local ULONG_PTR GdiplusScope::g_token = 0;
thread_local bool GdiplusScope::g_started = false;
在哪些地方必须加GdiplusScope实例
不是“整个程序加一个”，而是每个可能跨线程调用GDI+的入口点都要有。典型场景：
- Windows窗口过程（
WndProc）中创建GpBitmap或调用Graphics::DrawImage前 - Worker线程函数开头，只要该线程会创建
GpFont、GpPen等对象 - DLL导出函数内部，若函数体使用GDI+，且DLL可能被多线程加载
注意：如果某函数已处于GdiplusScope作用域内，嵌套再建一个不会出错（因为g_started标记防止重复启动），但没必要——纯浪费开销。
容易被忽略的兼容性陷阱
Win7及更早系统上，GdiplusStartup在某些低权限沙箱进程（如UWP容器内）可能返回GenericError；Win10 1809+引入GDI+的“轻量模式”，但GdiplusStartupInput结构体字段顺序和填充仍需严格对齐。实际开发中：
- 不要用
memset(&input, 0, sizeof(input))代替逐字段赋值——某些版本头文件中结构体含保留字段，未初始化会导致启动失败 - 链接时确保
gdiplus.lib被正确包含，且运行时GdiPlus.dll在PATH中（通常系统自带，但Server Core版可能缺失） - Release模式下若出现
GdiplusShutdown后再次调用GDI+ API崩溃，大概率是某个线程没走完GdiplusScope析构就退出了——检查线程是否detach而非join
线程生命周期比RAII对象长时，thread_local变量不会自动析构，必须确保线程函数末尾显式离开GdiplusScope作用域，或用std::unique_ptr托管其生存期。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
