PDEBUG_EXTENSION_INITIALIZE コールバック関数 (dbgeng.h)

DebugExtensionInitialize コールバック関数は、DbgEng 拡張機能 DLL を読み込んだ後、エンジンによって呼び出されます。

 CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;

構文

PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;

HRESULT PdebugExtensionInitialize(
  [out] PULONG Version,
  [out] PULONG Flags
)
{...}

[out] Version

拡張機能のバージョンを受け取ります。上位 16 ビットにはメジャーバージョン番号が含まれており、下位 16 ビットにはマイナーバージョン番号が含まれます。

[out] Flags

これを 0 に設定します。 (将来の使用のために予約されています。)

リターンコード	説明
S_OK	拡張機能が正常に初期化されました。

その他の値は、拡張 DLL が初期化できなかったことを示し、エンジンによってアンロードされます。

エンジンは、各拡張 DLL で名前によってこの関数を検索します。この関数は、DbgEng 拡張 DLL によってエクスポートする必要があります。

バージョン番号は、dbgeng.h で見つかったマクロ DEBUG_EXTENSION_VERSIONを使用して設定できます。次に例を示します。

*Version = DEBUG_EXTENSION_VERSION(Major, Minor)

この関数の実装では、拡張 DLL に必要なグローバル変数を初期化する必要があります。

この関数が呼び出されたときにセッションがアクティブになっている場合とない場合があるため、拡張機能ではセッション情報を照会できると想定しないでください。

関数型は、dbgeng.h でPDEBUG_EXTENSION_INITIALIZEとして定義されます。

要件	値
対象プラットフォーム	ユニバーサル
Header	dbgeng.h