PDEBUG_EXTENSION_NOTIFY回呼函式 (dbgeng.h)
引擎會呼叫 DebugExtensionNotify 回呼 函式,以在會話變更其作用中或可存取狀態時通知擴充 DLL 。
CALLBACK* PDEBUG_EXTENSION_NOTIFY DebugExtensionNotify;
語法
PDEBUG_EXTENSION_NOTIFY PdebugExtensionNotify;
void PdebugExtensionNotify(
[in] ULONG Notify,
[in] ULONG64 Argument
)
{...}
參數
[in] Notify
可以是下列任一值:
值 | Description |
---|---|
DEBUG_NOTIFY_SESSION_ACTIVE | 偵錯會話為作用中。 會話不一定暫停。 |
DEBUG_NOTIFY_SESSION_INACTIVE | 沒有作用中的偵錯會話。 |
DEBUG_NOTIFY_SESSION_ACCESSIBLE | 偵錯會話已暫止,且現在可以存取。 |
DEBUG_NOTIFY_SESSION_INACCESSIBLE | 偵錯會話已開始執行,現在無法存取。 |
[in] Argument
設定為零。 (保留供日後使用。)
傳回值
無
備註
此函式是選擇性的。 如果想要在會話狀態變更時收到通知,DbgEng 延伸模組 DLL 只需要匯出 DebugExtensionNotify 。 引擎會在擴充 DLL 中依名稱尋找此函式。
此函式可讓延伸模組 DLL 快取工作階段的相關信息,而不需要註冊明確的回呼。 它會在會話的開頭和結尾呼叫,每次目標啟動或停止執行時呼叫。
初始化擴充 DLL 之後,引擎將會使用此函式在啟動工作階段時通知 DLL。 如果目前的會話暫停,引擎會再次呼叫此函式,以通知 DLL 可存取會話。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | dbgeng.h |