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