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以获取调试信息。

返回值

此方法也可能返回错误值。 有关详细信息,请参阅 返回值

返回代码 描述
S_OK
该方法成功。

言论

注意 在调用 WaitForEvent 方法之前,引擎不会完全附加到内核。 只有在内核生成事件(例如初始断点)之后,它才会在调试器会话中可用。
 
有关连接到实时内核模式目标的详细信息,请参阅 实时 Kernel-Mode 目标

要求

要求 价值
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

AttachProcess

GetKernelConnectionOptions

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

IsKernelDebuggerEnabled