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

另请参阅

DebugExtensionInitialize