GdiplusStartupInputEx structure (gdiplusinit.h)

Important

Some information relates to a prerelease product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

The GdiplusStartupInputEx structure holds a block of arguments that are required by the GdiplusStartup function. GdiplusStartupInputEx derives from GdiplusStartupInput.

Syntax

struct GdiplusStartupInputEx : GdiplusStartupInput {
  INT  StartupParameters;
  void GdiplusStartupInputEx(
    INT            startupParameters,
    DebugEventProc debugEventCallback,
    BOOL           suppressBackgroundThread,
    BOOL           suppressExternalCodecs
  );
  void GdiplusStartupInputEx(
    Version        gdiplusVersion,
    INT            startupParameters,
    DebugEventProc debugEventCallback,
    BOOL           suppressBackgroundThread,
    BOOL           suppressExternalCodecs
  );
};

Inheritance

The GdiplusStartupInputEx structure implements GdiplusStartupInput.

Members

StartupParameters

Type: INT

See GdiplusStartupParams. The default value is GdiplusStartupDefault (0).

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

Constructor for the GdiplusStartupInputEx structure.

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

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

Constructor for the GdiplusStartupInputEx structure.

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

Remarks

The GdiplusStartupInputEx structure also defines the following enumeration, which is the type of one of the parameters of the GdiplusStartupInputEx.GdiplusStartupInputEx(Version,INT,DebugEventProc,BOOL,BOOL) constructor.

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.
};

Requirements

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