トレース メッセージ プレフィックス
Tracefmt は、イベント トレース ログ (.etl) ファイル と トレース メッセージ形式 (.tmf) ファイルに格納されているデータで構成される各トレース メッセージにプレフィックスを追加します。
Tracefmt はデフォルトで特定のデータ要素を含んでいますが、ユーザーは環境変数の %TRACE_FORMAT_PREFIX% (FormatMessage と互換性のあるメッセージ定義を指定する文字列) を変更して、要素の追加や削除を行うことができます。
デフォルトのトレース メッセージ プレフィックスの形式は次のとおりです。
[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]
次のプレフィックスが生成されます。
[CPUNumber]ProcessID.ThreadID :: SystemTime [MessageGUIDFriendlyName]
各 %n 変数は、次の表で説明しているパラメーターを表します。
| プレフィックス変数識別子 | 変数の型 | 説明 |
|---|---|---|
%1 |
string |
トレース メッセージの メッセージ GUID のフレンドリ名。 デフォルトでは、メッセージ GUID のフレンドリ名は、トレース プロバイダーがビルドされたディレクトリ名です。 メッセージ GUID のフレンドリ名を変更するには、Tracewpp または RUN_WPP マクロで -pパラメーターを使用します。 詳細については、Run_WPP オプションを参照してください。 |
2% |
string |
ソース ファイルと行番号。 この変数は、トレース メッセージのフレンドリ名を表します。 既定では、トレース メッセージのフレンドリ名は、ソース ファイルの名前と、トレース メッセージを生成したコードの行番号です。 |
%3 |
ULONG |
スレッド ID。 トレース メッセージを生成したスレッドを識別します。 |
4% |
string |
トレース メッセージが生成された時刻のタイムスタンプ。 |
5% |
string |
カーネル時間。 トレース メッセージが生成された時点でのカーネル モード命令の実行経過時間を CPU ティック単位で表示します。 |
%6 |
string |
ユーザー時間。 トレース メッセージが生成された時点でのユーザー モード命令の実行経過時間を CPU ティック単位で表示します。 |
7% |
LONG |
連番。 トレース メッセージのローカルまたはグローバル シーケンス番号を表示します。 ローカル シーケンス番号 (このトレース セッションでのみ一意) が既定です。 |
8% |
ULONG |
プロセス ID。 トレース メッセージを生成したプロセスを識別します。 |
%9 |
ULONG |
CPU 番号。 トレース メッセージが生成された CPU を識別します。 |
%!FUNC! |
string |
関数名。 トレース メッセージを生成した関数の名前を表示します。 |
%!FLAGS! |
string |
トレース メッセージを有効化するトレース フラグの名前を表示します。 (DoTraceMessage マクロはフラグとレベルの引数を逆にするため、DoTraceMessage によって生成されたメッセージは、このフィールドにトレース レベルの値を表示します) |
%!LEVEL! |
string |
トレース メッセージを有効化するトレース レベルの値を表示します。 (DoTraceMessage マクロはフラグとレベルの引数を逆にするため、DoTraceMessage によって生成されたメッセージは、このフィールドにトレース フラグの名前を表示します) |
%!COMPNAME! |
string |
コンポーネント名。 トレース メッセージを生成したプロバイダーのコンポーネントの名前を表示します。 コンポーネント名は、トレース コードで指定されている場合にのみ表示されます。 |
%!SUBCOMP! |
string |
サブコンポーネント名。 トレース メッセージを生成したプロバイダーのサブコンポーネントの名前を表示します。 コンポーネント名は、トレース コードで指定されている場合にのみ表示されます。 |
感嘆符内のシンボルは、変数の書式設定と精度を指定する変換文字です。 たとえば、%8!04X! です。 これは、4 桁の符号なし 16 進数として表されたプロセス ID を指定します。 必ず、これらの変換文字を含める必要があります。
トレース メッセージ プレフィックスの要素、順序、書式設定を変更するには、%TRACE_FORMAT_PREFIX% 環境変数を使用します。 例については、「例 7: トレース メッセージ プレフィックスのカスタマイズ」を参照してください。
TMF ファイル内のコンテンツの例については、「tracedrv サンプルのトレース メッセージの書式設定」を参照してください。
また、-csv パラメーターは、標準の Tracefmt プレフィックスの前に、構成不可能な詳細なプレフィックスを各トレース メッセージに追加します。 CSV プレフィックス内のフィールドの説明については、-csvheader パラメーターを使用します。