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。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | dbgeng.h |