Edit

GdiplusStartupInput::GdiplusStartupInput function (gdiplusinit.h)

  • Article

Constructor for the GdiplusStartupInput structure.

The constructor sets the GdiplusVersion member to 1. All of the constructor parameters are optional, so you can declare a variable of type GdiplusStartupInput without passing any arguments to the constructor, and all of the members will be initialized with appropriate default values.

Syntax

void GdiplusStartupInput(
  DebugEventProc debugEventCallback,
  BOOL           suppressBackgroundThread,
  BOOL           suppressExternalCodecs
);

Parameters

debugEventCallback

Type: DebugEventProc

Pointer to your DebugEventProc callback function, which GDI+ can call on debug builds for assertions and warnings. The default value is NULL.

suppressBackgroundThread

Type: BOOL

Boolean value that specifies whether to suppress the GDI+ background thread. If you pass TRUE, then GdiplusStartup returns (in its output parameter) a pointer to a hook function, and a pointer to an unhook function. You must call those functions appropriately to replace the background thread. If you don't want to be responsible for calling the hook and unhook functions, then set this member to FALSE. The default value is FALSE.

suppressExternalCodecs

Type: BOOL

Boolean value that specifies whether you want GDI+ to suppress external image codecs. GDI+ version 1.0 doesn't support external image codecs, so this parameter is ignored. The default value is FALSE.

Return value

None

Requirements

Requirement Value
Minimum supported client Windows 10 Build 20348
Minimum supported server Windows 10 Build 20348
Header gdiplusinit.h