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 関数へのポインターを ( 出力 パラメーターで) 返します。 バックグラウンド スレッドを置き換えるには、これらの関数を適切に呼び出す必要があります。 フック関数と unhook 関数を呼び出す必要がない場合は、このメンバーを FALSE に設定 します。 既定値は FALSE です。

SuppressExternalCodecs

種類: BOOL

GDI+ で外部イメージ コーデックを抑制するかどうかを指定するブール値。 GDI+ バージョン 1.0 では外部イメージ コーデックがサポートされていないため、このフィールドは無視されます。 既定値は FALSE です。

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

GdiplusStartupInput 構造体のコンストラクター。

コンストラクターは、 GdiplusVersion メンバーを 1 に設定します。 すべてのコンストラクター パラメーターは省略可能であるため、コンストラクターに引数を渡さずに GdiplusStartupInput 型の変数を宣言でき、すべてのメンバーは適切な既定値で初期化されます。

解説

GdiplusStartupInput 構造体は、GdiplusVersion メンバーを 1 に設定するコンストラクターを提供し、他の 3 つのメンバーの値を指定できます。 すべてのコンストラクター パラメーターは省略可能であるため、コンストラクターに引数を渡さずに GdiplusStartupInput 型の変数を宣言でき、すべてのメンバーは適切な既定値で初期化されます。

GdiplusStartup の入力パラメーターで SuppressBackgroundThread メンバーを TRUE に設定した場合は、その関数によって返される出力パラメーターで返されるフック関数と unhook 関数を呼び出す必要があります。 アプリケーションのメイン メッセージ ループの前後にこれらの関数を呼び出します。つまり、GDI+ の有効期間中アクティブなメッセージ ループです。 ループが開始される前にフック関数を呼び出し、ループの終了後に unhook 関数を呼び出します。

要件

関連項目

• [GdiplusShutdown]((windows/win32/api/gdiplusinit/nf-gdiplusinit-gdiplusshutdown)
• GdiplusStartup
• [GdiplusStartupOutput]((windows/win32/api/gdiplusinit/ns-gdiplusinit-gdiplusstartupoutput)
• はじめに