引擎调用 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 |