!wmitrace.searchpath

!wmitrace.searchpath 拡張機能は、トレース バッファー内のメッセージのトレース メッセージ フォーマット ファイルの場所を指定します。

!wmitrace.searchpath [+] TMFPath 
!wmitrace.searchpath

パラメーター

+
TMFPath が既存の検索パスに追加されるようにします。 プラス (+) トークンを使用しない場合は、TMFPath が既存の検索パスを置き換えます。

TMFPath
デバッガーがトレース メッセージ フォーマット ファイルを検索するディレクトリへのパス。 スペースを含むパスはサポートされていません。 複数のパスが含まれる場合は、パスをセミコロンで区切って、文字列全体を引用符で囲む必要があります。 パスが引用符で囲まれている場合は、円記号の前にエスケープ文字を付ける必要があります ( "c:\\debuggers;c:\\debuggers2" )。 + トークンを使用すると、 TMFPath が既存のパスに追加され、既存のパスと新しいパスの間にセミコロンが自動的に挿入されます。ただし、 + トークンを使用する場合、引用符は使用できません。

DLL

Wmitrace.dll

この拡張機能は、Windows 2000 以降のバージョンの Windows で使用できます。 この拡張機能を Windows 2000 で使用する場合は、まず、Windows 用デバッグ ツールのインストール ディレクトリの winxp サブディレクトリから w2kfre サブディレクトリに Wmitrace.dll ファイルをコピーする必要があります。

追加情報

イベント トレースの概念的な概要については、Microsoft Windows SDK を参照してください。 トレース メッセージ フォーマット ファイルについては、Windows Driver Kit (WDK) で「トレース メッセージ フォーマット ファイル」トピックを参照してください。

解説

パラメーターを指定せずに !wmitrace.searchpath を使用すると、現在の検索パスが表示されます。

トレース メッセージ フォーマット ファイル (*.tmf) には、トレース プロバイダーが生成するバイナリ トレース メッセージを書式設定するための指示が含まれています。

TMFPath パラメーターには、ディレクトリへのパスのみを含める必要があります。ファイル名を含めることはできません。 TMF ファイルの名前は、メッセージ GUID の後に拡張子 .tmf が付いたものです。 システムはメッセージを書式設定するときに、メッセージのメッセージ GUID を読み取り、指定されたディレクトリから始めてメッセージ GUID に一致する名前の TMF ファイルを再帰的に探します。

Windows では、バッファー内のバイナリ トレース メッセージを書式設定するために TMF ファイルが必要です。 !wmitrace.searchpath または !wmitrace.tmffile を使用してトレース バッファーの内容を表示する前に、!wmitrace.dynamicprint または !wmitrace.logdump を使用して TMF ファイルを指定します。

!wmitrace.searchpath または !wmitrace.tmffile のいずれも使用しない場合、システムは TRACE_FORMAT_SEARCH_PATH 環境変数の値を使用します。 その変数が存在しない場合は、Windows に含まれている default.tmf ファイルが使用されます。 トレース メッセージの書式設定情報が見つからない場合、システムはトレース メッセージの内容の代わりに「書式設定情報が見つかりません」という旨のエラー メッセージを書き込みます。