追蹤訊息前置詞
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 的易記名稱，請使用 -p 參數搭配 Tracewpp 或 RUN_WPP 宏。 如需詳細資訊，請參閱Run_WPP選項。 |
%2 |
string |
原始程式檔和行號。 這個變數代表追蹤訊息的易記名稱。 根據預設，追蹤訊息的易記名稱是來源檔案的名稱，以及產生追蹤訊息的程式程式碼號。 |
%3 |
ULONG |
執行緒識別碼。 識別產生追蹤訊息的執行緒。 |
%4 |
string |
產生追蹤訊息之時間的時間戳記。 |
%5 |
string |
核心時間。 在產生追蹤訊息時，在 CPU 刻度中顯示核心模式指令經過的執行時間。 |
%6 |
string |
使用者時間。 在產生追蹤訊息時，以 CPU 刻度顯示使用者模式指令的經過執行時間。 |
%7 |
LONG |
序號。 顯示追蹤訊息的本機或全域序號。 只有這個追蹤會話唯一的本機序號是預設值。 |
%8 |
ULONG |
進程識別碼。 識別產生追蹤訊息的進程。 |
%9 |
ULONG |
CPU 號碼。 識別產生追蹤訊息的 CPU。 |
%!FUNC！ |
string |
函式名稱。 顯示產生追蹤訊息的函式名稱。 |
%!標誌！ |
string |
顯示啟用追蹤訊息的 追蹤旗標 名稱。 (因為 DoTraceMessage 宏會反轉旗標和層級引數，所以 DoTraceMessage 所產生的訊息會顯示此欄位中 追蹤層級 的值。) |
%!水準！ |
string |
顯示啟用追蹤訊息的 追蹤層級 值。 (因為 DoTraceMessage 宏會反轉旗標和層級引數，所以 DoTraceMessage 所產生的訊息會顯示此欄位中 追蹤旗 標的名稱。) |
%!COMPNAME！ |
string |
元件名稱。 顯示產生追蹤訊息之提供者元件的名稱。 只有在追蹤程式碼中指定元件名稱時才會出現。 |
%!SUBCOMP！ |
string |
子元件名稱。 顯示產生追蹤訊息之提供者的子元件名稱。 只有在追蹤程式碼中指定元件名稱時才會出現。 |
驚嘆號內的符號是指定變數格式和精確度的轉換字元。 例如，%8！04X！ 指定以四位數無符號十六進位數位表示的進程識別碼。 必須包含這些轉換字元。
若要變更追蹤訊息前置詞的專案、順序或格式，請使用 %TRACE_FORMAT_PREFIX% 環境變數。 如需範例，請參閱 範例 7：自訂追蹤訊息前置詞。
如需 TMF 檔案中內容的範例，請參閱格式化來自 tracedrv 範例的追蹤訊息。
此外， -csv 參數會在標準 Tracefmt 前置詞之前，將不可設定的詳細前置詞新增至每個追蹤訊息。 如需 CSV 前置詞中欄位的描述，請使用 -csvheader 參數。