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 |