什麼是 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位址。 |
%!港口! | 顯示埠號碼。 |