GdiplusStartupInput 结构

GdiplusStartupInput 结构

该结构持有GdiplusStartup函数所需要使用的一组参数.

Syntax

struct GdiplusStartupInput
{
    UINT32 GdiplusVersion;             
    DebugEventProc DebugEventCallback;
    BOOL SuppressBackgroundThread;
    BOOL SuppressExternalCodecs; 
    
    GdiplusStartupInput(
        DebugEventProc debugEventCallback = NULL,
        BOOL suppressBackgroundThread = FALSE,
        BOOL suppressExternalCodecs = FALSE)
    {
        GdiplusVersion = 1;
        DebugEventCallback = debugEventCallback;
        SuppressBackgroundThread = suppressBackgroundThread;
        SuppressExternalCodecs = suppressExternalCodecs;
    }
};

typedef VOID (WINAPI *DebugEventProc)(DebugEventLevel level, CHAR *message);

成员

GdiplusVersion

指定Microsoft Windows GDI+的版本. 必须为 1.

DebugEventCallback           默认为NULL,一个用于调试的回调函数。
SuppressBackgroundThread

用于指定是否压缩GDI+背景线程的布尔值。如果设置该成员为TRUE， GdiplusStartup 返回一个指向挂钩函数和一个解勾函数的指针。必须调用这些函数来妥善的替换掉背景线程。如果不想调用这些函数，这是这个成员为FALSE。默认值为FALSE

SuppressExternalCodecs

指定是否让GDI+压缩外部图片codecs的布尔值。1.0不支持该功能，所以该值被忽略。

备注

该结构其实就是一个构造器，可以设置它的四个成员的值，如果不设置的话，也可以提供一个空的结构，系统会自动为这些成员提供合适的初始默认值

调用钩子函数时，要注意使用解勾函数。

结构信息

Header	Declared in Gdiplusinit.h, include gdiplus.h
Import library	gdiplus.lib
Minimum availability	GDI+ 1.0
Minimum operating systems	Windows 98/Me, Windows XP, Windows 2000, Windows NT 4.0 SP6