IDebugClient2::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 の値によって異なります。

ConnectOptions は、WinDbg および KD コマンドラインの -k スイッチに続くオプションと同じように解釈されます。環境変数は、-k スイッチに影響するのと同じ方法で ConnectOptions に影響します。

eXDI ドライバーについては、このドキュメントでは説明しません。ハードウェアプローブまたはハードウェアシミュレーターへの eXDI インターフェイスがある場合は、デバッグ情報について Microsoft にお問い合わせください。

このメソッドは、エラー値を返す場合もあります。詳細については、「戻り値」を参照してください。

リターンコード	説明
S_OK	メソッドは正常に実行されました。

メモWaitForEvent メソッドが呼び出されるまで、エンジンはカーネルに完全にアタッチしません。カーネルがイベントを生成した後 (たとえば、最初のブレークポイント)、デバッガーセッションで使用できるようになります。

ライブカーネルモードターゲットへの接続の詳細については、「 Live Kernel-Mode Targets」を参照してください。

要件	値
対象プラットフォーム	デスクトップ
Header	dbgeng.h (Dbgeng.h を含む)