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