IDebugClient5::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 的解释取决于 Flags 的值。

DEBUG_ATTACH_KERNEL_CONNECTION

ConnectOptions 的解释方式与 WinDbg 和 KD 命令行上的 -k 开关后面的选项相同。 环境变量影响 ConnectOptions 的方式与影响 -k 开关的方式相同。

DEBUG_ATTACH_EXDI_DRIVER

本文档中未介绍 eXDI 驱动程序。 如果你有硬件探测或硬件模拟器的 eXDI 接口,请联系 Microsoft 获取调试信息。

返回值

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

返回代码 说明
S_OK
方法成功。

注解

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

要求

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

另请参阅

AttachProcess

GetKernelConnectionOptions

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

IsKernelDebuggerEnabled