GdiplusStartupInputEx::GdiplusStartupInputEx(Version,INT,DebugEventProc,BOOL,BOOL) 函数 (gdiplusinit.h)

重要

某些信息与预发行产品有关,该产品在商业发布之前可能会进行大幅修改。 Microsoft对此处提供的信息不作任何明示或暗示的保证。

GdiplusStartupInputEx 结构的构造函数。

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

语法

void GdiplusStartupInputEx(
  Version        gdiplusVersion,
  INT            startupParameters,
  DebugEventProc debugEventCallback,
  BOOL           suppressBackgroundThread,
  BOOL           suppressExternalCodecs
);

参数

gdiplusVersion

类型:版本

要初始化的 GDI+ 版本。 请参阅下面的 版本 枚举的定义。

![重要提示]有关以下编解码器的操作系统(OS)支持的信息,请参阅 Windows 10/11 N 媒体功能包(2022 年 9 月)

enum class Version : UINT32
{
  V2 = 2,
  V3 = 3 // Enables Heif and Avif image codecs.
         // Unlike other functionalities in Gdiplus,
         // these two codecs require COM to be initialized.
};

startupParameters

类型:INT

请参阅 GdiplusStartupParams。 默认值为 GdiplusStartupDefault (0)。

debugEventCallback

类型:DebugEventProc

指向 DebugEventProc 回调函数的指针,GDI+ 可以对断言和警告的调试生成进行调用。 默认值为 NULL

suppressBackgroundThread

类型:BOOL

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

suppressExternalCodecs

类型:BOOL

指定是否希望 GDI+ 禁止外部图像编解码器的布尔值。 默认值为 FALSE

返回值

没有

要求

要求 价值
标头 gdiplusinit.h