PDEBUG_EXTENSION_INITIALIZE回呼函式 (dbgeng.h)

載入 DbgEng 延伸模組 DLL 之後，引擎會呼叫 DebugExtensionInitialize 回呼函式。

 CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;

語法

PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;

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

[out] Version

接收延伸模組的版本。高16位包含主要版本號碼，而低16位則包含次要版本號碼。

[out] Flags

將此設定為零。 (保留供日後使用。)

傳回碼	描述
S_OK	已成功初始化延伸模組。

任何其他值都表示擴充 DLL 無法初始化，而且引擎會卸除它。

引擎會依名稱在每個擴充 DLL 中尋找此函式。此函式必須由 DbgEng 延伸模組 DLL 匯出。

您可以使用 dbgeng.h 中找到的宏DEBUG_EXTENSION_VERSION來設定版本號碼，例如：

*Version = DEBUG_EXTENSION_VERSION(Major, Minor)

此函式的實作應該初始化擴充 DLL 所需的任何全域變數。

呼叫此函式時，可能或可能沒有作用中的會話，因此延伸模組不應該假設它能夠查詢會話資訊。

函式類型在 dbgeng.h 中定義為 PDEBUG_EXTENSION_INITIALIZE。

需求	值
目標平台	Universal
標頭	dbgeng.h