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

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

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

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

リターンコード	形容
S_OK	メソッドが成功しました。

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

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

要件	価値
ターゲットプラットフォームの	デスクトップ
ヘッダー	dbgeng.h (Dbgeng.h を含む)