WPP 包含預先定義的格式規格字串,除了針對 printf 定義的標準格式字串之外,您還可以在追蹤訊息中使用。
您可以在追蹤訊息前綴中,及任何追蹤函式或巨集中,使用%!FLAGS!、%!FUNC! 和 %!LEVEL!字串,例如DoTraceMessage。
您可以在任何追蹤函式中使用其他擴充字串。
tracewpp 的預設組態選項
WPP 會針對預設組態設定使用 「defaultwpp.ini」。 此預設 INI 檔案包含在 WppConfig Rev1 目錄中的 Windows SDK 中。 如需 WPP 預設行為的最新資訊,以及自定義的其他資訊,請參閱此 INI 檔案。
軟體追蹤
| 格式字串 | 說明 |
|---|---|
| %!檔! | 顯示產生追蹤訊息的來源檔名。 此變數也可以在 追蹤訊息前置詞中使用。 |
| %!旗幟! | 顯示啟用追蹤訊息的 追蹤旗標 值。 此變數也可以在 追蹤訊息前置詞中使用。 |
| %!FUNC! | 顯示產生追蹤訊息的函式。 此變數也可以在 追蹤訊息前置詞中使用。 |
| %!水準! | 顯示啟用追蹤訊息的 追蹤層級 名稱。 此變數也可以在 追蹤訊息前置詞中使用。 |
| %!LINE! | 顯示產生追蹤前置詞之程式代碼中的行號。 此變數也可以在 追蹤訊息前置詞中使用。 |
一般用途
| 格式字串 | 說明 |
|---|---|
| %!bool! | 顯示真或假 |
| %!irql! | 顯示目前 IRQL 的名稱。 |
| %!sid! | 表示指向安全性識別碼 (pSID) 的指標。 顯示 SID。 |
| GUID | |
| %!GUID! | 表示一個指向 GUID(pGUID)的指標。 顯示指向的 GUID。 |
| %!CLSID! | 類別標識碼。 表示指向類別 ID 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! %!TIME! |
在特定時刻顯示系統時間的值。 這些是以 SYSTEMTIME 格式顯示的 LONGLONG (SINT64) 值。 您可以使用這些變數來代表程式中的不同時間值,並加以區別。 |
傳回碼
| 格式字串 | 說明 |
|---|---|
| %!狀態! | 表示狀態值,並顯示與狀態代碼相關聯的字串。 |
| %!WINERROR! | 代表 Windows 錯誤碼,並顯示與錯誤相關聯的字串。 |
| %!HRESULT! | 表示錯誤或警告,並以 HRESULT 格式顯示程式代碼。 |
網路
| 格式字串 | 說明 |
|---|---|
| %!IPADDR! | 表示IP位址的指標。 顯示IP位址。 |
| %!港口! | 顯示埠號碼。 |