IDebugClient::AttachKernel 方法 (dbgeng.h)
AttachKernel 方法将 调试器引擎 连接到内核目标。
语法
HRESULT AttachKernel(
[in] ULONG Flags,
[in, optional] PCSTR ConnectOptions
);
参数
[in] Flags
指定控制调试器如何附加到内核目标的标志。 可能的值包括:
价值 | 描述 |
---|---|
DEBUG_ATTACH_KERNEL_CONNECTION | 附加到目标计算机上的内核。 |
DEBUG_ATTACH_EXDI_DRIVER | 使用 eXDI 驱动程序附加到内核。 |
[in, optional] ConnectOptions
指定用于与运行内核目标的计算机通信的连接设置。 ConnectOptions 的解释取决于 标志的值。
DEBUG_ATTACH_KERNEL_CONNECTION
ConnectOptions 与 WinDbg 和 KD 命令行上的 -k 开关后面的选项相同。 环境变量以影响 -k 开关的方式影响 ConnectOptions。
DEBUG_ATTACH_EXDI_DRIVER
本文档未介绍 eXDI 驱动程序。 如果硬件探测或硬件模拟器有 eXDI 接口,请联系Microsoft以获取调试信息。
返回值
此方法也可能返回错误值。 有关详细信息,请参阅 返回值。
返回代码 | 描述 |
---|---|
|
该方法成功。 |
言论
注意 在调用 WaitForEvent 方法之前,引擎不会完全附加到内核。 只有在内核生成事件(例如初始断点)之后,它才会在调试器会话中可用。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |