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
將此設定為零。 (保留供日後使用。)
傳回值
傳回碼 | 描述 |
---|---|
|
已成功初始化延伸模組。 |
任何其他值都表示擴充 DLL 無法初始化,而且引擎會卸除它。
備註
引擎會依名稱在每個擴充 DLL 中尋找此函式。 此函式必須由 DbgEng 延伸模組 DLL 匯出。
您可以使用 dbgeng.h 中找到的宏DEBUG_EXTENSION_VERSION來設定版本號碼,例如:
*Version = DEBUG_EXTENSION_VERSION(Major, Minor)
此函式的實作應該初始化擴充 DLL 所需的任何全域變數。
呼叫此函式時,可能或可能沒有作用中的會話,因此延伸模組不應該假設它能夠查詢會話資訊。
函式類型在 dbgeng.h 中定義為 PDEBUG_EXTENSION_INITIALIZE。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | dbgeng.h |