什麼是 WPP 擴充格式規格字串

WPP 包含預先定義的格式規格字串,除了針對 printf 定義的標準格式字串之外,您還可以在追蹤訊息中使用。

您可以使用 %!FLAGS!%!FUNC!%!水準!追蹤訊息前置詞中的字串,以及任何追蹤函式或宏中的字串,例如 DoTraceMessage

您可以在任何追蹤函式中使用其他擴充字串。

tracewpp 的預設組態選項

WPP 會使用 「defaultwpp.ini」 做為預設組態設定。 此預設 INI 檔案包含在 WppConfig Rev1 目錄中的 Windows SDK 中。 如需 WPP 預設行為的最新資訊,以及自定義的其他資訊,請參閱此 INI 檔案。

軟體追蹤

格式字串 描述
%!檔! 顯示產生追蹤訊息的來源檔名。 此變數也可用於 追蹤訊息前置詞中。
%!標誌! 顯示啟用追蹤訊息的 追蹤旗標 值。 此變數也可用於 追蹤訊息前置詞中。
%!FUNC! 顯示產生追蹤訊息的函式。 此變數也可用於 追蹤訊息前置詞中。
%!水準! 顯示啟用追蹤訊息的 追蹤層級 名稱。 此變數也可用於 追蹤訊息前置詞中。
%!線! 在產生追蹤前置詞的程式代碼中顯示行號。 此變數也可用於 追蹤訊息前置詞中。

一般使用

格式字串 描述
%!bool! 顯示TRUE或 FALSE
%!irql! 顯示目前 IRQL 的名稱。
%!sid! 表示安全性標識碼 (pSID) 的指標。 顯示 SID。
GUID
%!Guid! 表示 guiD (pGUID) 的指標。 顯示指向的 GUID。
%!Clsid! 類別標識碼。 表示類別標識碼 GUID 的指標。 顯示與 GUID 相關聯的字串。 WPP 會在格式化追蹤訊息時,找出登錄中的字串。
%!LIBID! 型別程式庫。 表示 COM 類型庫的 GUID。 顯示與 GUID 相關聯的字串。 WPP 會在格式化追蹤訊息時,找出登錄中的字串。
%!Iid! 介面識別碼。 表示介面識別碼 GUID 的指標。 顯示與 GUID 相關聯的字串。 WPP 會在格式化追蹤訊息時,找出登錄中的字串。
時間
%!delta! 顯示兩個時間值之間的差異,以毫秒為單位。 這是 以 day~h:m:s 格式顯示的 LONGLONG 值。
%!WAITTIME! 顯示等待某個專案完成所花費的時間,以毫秒為單位。 這是 以 day~h:m:s 格式顯示的 LONGLONG 值。 設計成與 %!due!搭配使用。
%!due! 顯示預期完成的時間,以毫秒為單位。 這是 以 day~h:m:s 格式顯示的 LONGLONG 值。 設計成與 %! 搭配使用WAITTIME!
%!時間 戳!
%!datetime!
%!時間!
在特定時間顯示系統時間的值。 這些是 LONGLONG (SINT64) 以 SYSTEMTIME 格式顯示的值。
您可以使用這些變數來代表程式中的不同時間值,並加以區別。

傳回碼

格式字串 描述
%!地位! 表示狀態值,並顯示與狀態代碼相關聯的字串。
%!WINERROR! 表示 Windows 錯誤碼,並顯示與錯誤相關聯的字串。
%!HRESULT! 表示錯誤或警告,並以 HRESULT 格式顯示程式代碼。

網路

格式字串 描述
%!IPADDR! 表示IP位址的指標。 顯示IP位址。
%!港口! 顯示埠號碼。