(dbgeng.h) IDebugClient5::AttachKernel 方法

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 參數後面的選項相同。 環境變數會以影響-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