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
可以是下列任一值:
價值 | 描述 |
---|---|
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 該會話可供存取。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | dbgeng.h |