!wdfkd.wdftmffile
!wdfkd.wdftmffile 拡張機能は、デバッガーが !wdfkd.wdflogdump または !wdfkd.wdfcrashdump 拡張機能のカーネル モード ドライバー フレームワーク (KMDF) エラー ログ レコードを書式設定するときに使用するトレース メッセージ フォーマット (.tmf) ファイルを設定します。
!wdfkd.wdftmffile TMFpath
パラメーター
TMFpath
.tmf ファイルを含むパス。
DLL
Wdfkd.dll
フレームワーク
KMDF 1, UMDF 2
追加情報
詳細については、カーネルモード・ドライバー・フレームワークのデバッグを参照してください。
解説
ドライバーが 1.11 より前の KMDF バージョンを使用している場合は、!wdfkd.wdflogdump または !wdfkd.wdfcrashdump 拡張機能を使用する前に、!wdfkd.wdftmffile 拡張機能を使用する必要があります。
KMDF バージョン 1.11 以降、フレームワーク ライブラリのシンボル ファイル (wdf01000.pdb など) にはトレース メッセージ フォーマット (TMF) のエントリが含まれています。 Windows 8 バージョンのカーネル デバッガー以降、カーネル モード ドライバー フレームワーク拡張機能 (Wdfkd.dll) は .pdb ファイルからエントリを読み取ります。 その結果、ドライバーが KMDF バージョン 1.11 以降を使用し、Windows 8 以降のカーネル デバッガーを使用している場合は、!wdfkd.wdftmffile を使用する必要はありません。 シンボル ファイルを含むディレクトリをデバッガーのシンボル パスに含める必要があります。 デバッグ対象のコンピューターは、KMDF をサポートする任意のオペレーティング システムで実行できます。
次の例では、KMDF バージョン 1.5 の場合に、ルート WDK ディレクトリから !.wdfkd.wdftmffile 拡張機能を使用する方法を示しています。
kd> !wdftmffile tools\tracing\<platform>\wdf1005.tmf
使用している Windows Driver Kit (WDK) のバージョンによっては、パスが異なる場合があることに注意してください。 また、.tmf ファイルの名前は、使用している KMDF のバージョンを表すことにも注意してください。 たとえば、Wdf1005.tmf は KMDF バージョン 1.5 の .tmf ファイルです。
デバッグ セッション中に KMDF ログを表示する方法については、「フレームワークのイベント ロガーの使用」を参照してください。