カーネル デバッガーにトレース メッセージを送信する方法

複数のメソッドを使用して、トレース メッセージをカーネル モード デバッガーにリダイレクトできます。 次に例をいくつか示します。

トレース メッセージは、KD または Windbg にリダイレクトできます。接続されている方にリダイレクトできます。 デバッガーは、デバッグ (null モデム) ケーブルを備えた COM ポート、または I Enterprise Edition E 1394 ケーブルを使用した 1394 ("firewire") ポートを介して接続する必要があります。 NTSD などの他のカーネル デバッガーにトレース メッセージをリダイレクトすることはできません。

デバッガーでトレース メッセージを表示するには、ホスト コンピューター上のデバッガーの検索パスにwmitrace.dllとtraceprt.dllする必要があります。 これらの DLL は、 Windows 用デバッグ ツール にも含まれています。デバッガーがトレース メッセージの トレース メッセージ形式 (.tmf) ファイル を検索できるようにするには、TMF ファイルがホスト コンピューター上のデバッガーの検索パスにある必要があります。 デバッガーの検索パスを設定するには、!wmitrace.searchpath 専用デバッガー拡張機能を使用するか、%TRACE_FORMAT_SEARCH_PATH% 環境変数の値を設定します。

詳細については、「Windows 用デバッグ ツール」で 「!wmitrace」を検索してください。

Logman

次の Logman コマンドを使用して、トレース メッセージをカーネル モード デバッガーにリダイレクトします。

logman start TraceSession -ets -mode KernelFilter -bs 3

-ets パラメーターは 、 パフォーマンス ログとアラート サービスによって制御されないイベント トレース セッションを開始します。 -mode パラメーターは、 KernelFilter オプションを含む詳細オプションをアクティブにします。

-bs パラメーターは、トレース セッションのバッファー サイズを、デバッガーの最大バッファー サイズである 3 KB (キロバイト)に設定します。 このパラメーターを省略すると、デバッガー セッションは正しく動作しません。

Logman は Windows XP 以降のバージョンの Windows に含まれています。

Tracelog

次の Tracelog コマンドを使用して、トレース メッセージをカーネル モード デバッガーにリダイレクトします。

tracelog -start MyTrace -guid MyProvider.ctl -rt -kd

-guid パラメーターは、 トレース プロバイダーを指定します。 -rt パラメーターは、リアルタイム トレース セッションを指定します。 -kd パラメーターは、トレース メッセージをカーネル デバッガーにリダイレクトし、最大バッファー サイズを 3 KB (キロバイト) (デバッガーの最大値) に設定します。

例については、「例 16: デバッガーでのトレース メッセージの表示」を参照 してください。

Tracelog は WDK の tools\tracing\<Platform> サブディレクトリにあります。ここで、 <Platform> は i386、amd64、または ia64 です。

TraceView

TraceView にはグラフィカル ユーザー インターフェイスがあります。

トレース セッションの作成時に、トレース メッセージをカーネル デバッガーにリダイレクトできます。 [ログ セッション オプション] ページで、 [詳細なログ セッション オプション] をクリックし、 [ログ セッション パラメーター オプション] タブをクリックし、 [Windbg] オプションの値を TRUE に変更します。 このオプションは、トレース セッションの実行中に変更できません。

TraceView は WDK の tools\tracing\<Platform> サブディレクトリにあります。ここで、 <Platform> は i386、amd64、または ia64 です。