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 函式的指標。 您必須適當地呼叫這些函式，才能取代背景執行緒。 如果您不想要負責呼叫勾點和取消hook 函式，請將此成員設定為 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，則必須呼叫該函式所傳回的輸出參數中所傳回的勾點和取消hook 函式。 在應用程式的主要訊息迴圈前後呼叫這些函式;也就是說，在 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)
• 快速入門