共用方式為


追蹤訊息前綴

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

字串

追蹤訊息 GUID 的易記名稱。 根據預設,訊息 GUID 的易記名稱是 建立追蹤提供者 所在的目錄名稱。

若要變更訊息 GUID 的易記名稱,請搭配 Tracewpp 或 RUN_WPP 巨集使用參數 -p。 如需詳細資訊,請參閱Run_WPP選項。

%2

字串

原始程式檔和行號。

此變數代表追蹤訊息的易記名稱。 根據預設,追蹤訊息的易記名稱是來源檔案的名稱,以及產生追蹤訊息的程式代碼行號。

%3

ULONG

線程標識碼。

識別產生追蹤訊息的線程。

%4

字串

產生追蹤訊息的時間時間戳。

%5

字串

核心時間。

在產生追蹤訊息時,以 CPU 刻度顯示核心模式指令的經過運行時間。

%6

字串

用戶時間。

在產生追蹤訊息時,以 CPU 刻度顯示使用者模式指令的經過運行時間。

%7

長時間

序號。

顯示追蹤訊息的本地或全球序列號。 在此追蹤會話中,僅專屬於此的本地序號是預設值。

%8

ULONG

進程標識碼。

識別產生追蹤訊息的程式。

%9

ULONG

CPU 號碼。

識別產生追蹤訊息的CPU。

%!FUNC!

字串

函式名稱。

顯示產生追蹤訊息的函式名稱。

%!旗幟!

字串

顯示啟用追蹤訊息的 追蹤旗標 名稱。

(因為 DoTraceMessage 巨集會反轉旗標和層級自變數,DoTraceMessage 所產生的訊息會顯示此字段中 追蹤層級 的值。

%!水準!

字串

顯示啟用追蹤訊息之 追蹤層級 的值。

(因為 DoTraceMessage 巨集會反轉旗標和層級自變數,DoTraceMessage 所產生的訊息會顯示此字段中 追蹤旗 標的名稱。

%!COMPNAME!

字串

元件名稱。

顯示產生追蹤訊息之提供者元件的名稱。 只有在追蹤程式代碼中指定元件名稱時才會出現。

%!SUBCOMP!

字串

子元件名稱。

顯示產生追蹤訊息之提供者的子元件名稱。 只有在追蹤程式代碼中指定元件名稱時才會出現。

驚嘆號內的符號是指定變數格式和精確度的轉換字元。 例如,%8!04X! 指定以四位數、不帶正負號十六進位數位表示的進程標識碼。 必須包含這些轉換字元。

若要變更追蹤訊息前置詞的專案、順序或格式設定,請使用 %TRACE_FORMAT_PREFIX% 環境變數。 如需範例,請參閱 範例 7:自定義追蹤訊息前置詞

如需範例TMF檔案中的內容,請參閱來源於tracedrv範例的格式化追蹤訊息。

此外, -csv 參數會在標準 Tracefmt 前置詞之前,將不可設定的詳細前置詞新增至每個追蹤訊息。 如需 CSV 前置詞中字段的描述,請使用 -csvheader 參數。