GdiplusStartupInput 结构 (gdiplusinit.h)

GdiplusStartupInput 结构包含 GdiplusStartup 函数所需的参数块。

语法

struct GdiplusStartupInput {
  UINT32         GdiplusVersion;
  DebugEventProc DebugEventCallback;
  BOOL           SuppressBackgroundThread;
  BOOL           SuppressExternalCodecs;
  void           GdiplusStartupInput(
    DebugEventProc debugEventCallback,
    BOOL           suppressBackgroundThread,
    BOOL           suppressExternalCodecs
  );
};

成员

GdiplusVersion

类型： UINT32

指定 GDI+ 的版本。 必须为 1。

DebugEventCallback

类型： DebugEventProc

指向 GDI+ 可以在调试版本中调用的回调函数的指针，用于断言和警告。 默认值为 NULL。

SuppressBackgroundThread

类型： BOOL

指定是否取消 GDI+ 后台线程的布尔值。 如果将此成员设置为 TRUE， 则 GdiplusStartup 将返回其 输出 参数中的 (，) 指向挂钩函数的指针和指向 unhook 函数的指针。 必须适当地调用这些函数才能替换后台线程。 如果不想负责调用挂钩和取消挂钩函数，请将此成员设置为 FALSE。 默认值为 FALSE。

SuppressExternalCodecs

类型： BOOL

指定是否希望 GDI+ 取消外部图像编解码器的布尔值。 GDI+ 版本 1.0 不支持外部图像编解码器，因此忽略此字段。 默认值为 FALSE。

void GdiplusStartupInput ( DebugEventProc debugEventCallback， BOOL suppressBackgroundThread， BOOL suppressExternalCodecs)

GdiplusStartupInput 结构的构造函数。

构造函数将 GdiplusVersion 成员设置为 1。 所有构造函数参数都是可选的，因此可以声明 类型为 GdiplusStartupInput 的变量，而无需将任何参数传递给构造函数，并且将使用适当的默认值初始化所有成员。

注解

GdiplusStartupInput 结构提供了一个构造函数，该构造函数将 GdiplusVersion 成员设置为 1，并允许你为其他三个成员指定值。 所有构造函数参数都是可选的，因此可以声明 类型为 GdiplusStartupInput 的变量，而无需将任何参数传递给构造函数，并且将使用适当的默认值初始化所有成员。

如果在 GdiplusStartup 的输入参数中将 SuppressBackgroundThread 成员设置为 TRUE，则必须调用该函数返回的输出参数中返回的挂钩和取消挂钩函数。 在应用程序main消息循环之前和之后调用这些函数;即，在 GDI+ 的生存期内处于活动状态的消息循环。 在循环开始之前调用挂钩函数，并在循环结束后调用 unhook 函数。

要求

最低受支持的客户端	Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	gdiplusinit.h (包括 gdiplus.h)

另请参阅

• [GdiplusShutdown] ( (windows/win32/api/gdiplusinit/nf-gdiplusinit-gdiplusshutdown)
• GdiplusStartup
• [GdiplusStartupOutput] ( (windows/win32/api/gdiplusinit/ns-gdiplusinit-gdiplusstartupoutput)
• 入门