IDebugClient5::AttachKernelWide 方法 (dbgeng.h)

AttachKernelWide 方法将调试器引擎连接到内核目标。

语法

HRESULT AttachKernelWide(
  [in]           ULONG  Flags,
  [in, optional] PCWSTR 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目标

要求

   
目标平台 桌面
Header dbgeng.h (包括 Dbgeng.h)

另请参阅

AttachProcess

GetKernelConnectionOptions

IDebugClient5

IsKernelDebuggerEnabled