イベント トレース

Windows イベント トレーシング (ETW) または Windows ソフトウェア トレース プリプロセッサ (WPP) を使用して、HID over I²C デバイス ドライバーの操作をトレースできます。 ETW の詳細については、Windows 開発のリファレンスのトピック「イベント トレース」を参照してください。 WPP の詳細については、「WPP ソフトウェア トレース」と「トレースをログ記録するためのインフライト トレース レコーダー (IFR)」を参照してください。

インフライト トレース レコーダー (IFR) の使用

すべてのドライバーに対して既定で有効になっているインフライト トレース レコーダー (IFR) を使用すると、HIDI²C ドライバーからカーネル デバッガーへのトレース出力を表示できます。 次のコマンドは、HIDI²C の WPP トレース メッセージを表示します。

!rcdrkd.rcdrlogdump hidi2c

インフライト トレース レコーダー (IFR) は、これらのトレース メッセージを固定サイズの循環バッファーに格納します。 その結果、出力にトレース ログ全体が含まれていない可能性があります。

logman.exe の使用

より詳細で制御可能なトレースを得るには、logman.exe を使用してトレースをキャプチャできます。 次のコマンドは、HIDI²C の WPP トレースをキャプチャします。

Logman create trace -n HIDI2C_WPP -o HIDI2C_WPP.etl -nb 128 640 -bs 128 
Logman update trace -n HIDI2C_WPP -p {E742C27D-29B1-4E4B-94EE-074D3AD72836} 0x7FFFFFFF 255
Logman start –n HIDI2C_WPP
 
<RUN your SCENARIO here>

Logman stop -n HIDI2C_WPP
Logman delete -n HIDI2C_WPP

HIDI²C の PDB ファイルまたは TMF ファイルを使用して、結果のトレース ログ ファイルをテキストに解析できます。

ETW トレースの有効化

HIDI²C ドライバーは、特定のイベントの ETW イベントをログに記録します。 これらのイベントは、イベント ビューアー ログに記録されます。

これらのイベントは、次の logman.exe コマンドを使用して表示することもできます。

Logman create trace -n HIDI2C_ETW -o HIDI2C_ETW.etl -nb 128 640 -bs 128 
Logman update trace -n HIDI2C_ETW -p Microsoft-Windows-SPB-HIDI2C 
Logman start –n HIDI2C_ETW
 
<RUN your SCENARIO here>

Logman stop -n HIDI2C_ETW
Logman delete -n HIDI2C_ETW

結果のトレース ログは、Xperf や Windows Performance Analyzer (WPA) などのツールで解析できます。