共用方式為


追蹤訊息格式檔案

追蹤訊息格式 (TMF) 檔案是結構化文字檔,其中包含剖解析及格式化追蹤提供者所產生的二進位追蹤訊息的指示。 格式設定指示包含在追蹤提供者的原始程式碼中,並由 WPP 前置處理器新增至追蹤提供者的 PDB 符號檔。

某些記錄及顯示格式化追蹤訊息的工具需要 TMF 檔案。 TracefmtTraceView 是格式化和顯示追蹤訊息的 WDK 工具,可以使用 TMF 檔案,也可以直接從 PDB 符號檔擷取格式設定資訊。

您可以使用 Tracefmt 並包含 -i 參數來建立 TMF 檔案,這會指示 Tracefmt 建立 Tracedrv 的 TMF 檔案。 如需詳細資訊,請參閱 範例 9:建立 TMF 檔案

如果您沒有 追蹤提供者的 TMF 檔案,請使用 Tracepdb。 Tracepdb 會從 PDB 符號檔擷取格式化指示,並建立 TMF 檔案來儲存它們。 許多應用程式和驅動程式開發人員偏好提供 TMF 檔案,而不是 PDB 符號檔案。

TMF 檔案的名稱是與該 TMF 檔案相關聯之訊息的 訊息 GUID 。 ETW 會使用訊息 GUID 將特定追蹤訊息與保留其格式設定指示的 TMF 檔案產生關聯。

TMF 檔案包含下列資料:

  • 從中擷取 TMF 檔案資料的 PDB 檔案名稱。

  • 來源檔案中追蹤訊息的 訊息 GUID 和來源檔名。

  • 對於每個追蹤訊息,都有一項目指定訊息類型、原始碼檔名、行號、訊息號碼、訊息定義字串、追蹤標誌名稱,以及包含巨集呼叫的 C 函數名稱。

  • 其值出現在追蹤訊息中的變數清單及其相關聯的內部類型名稱。 變數由訊息定義字串中的 %n 表示法表示。

注意 TMF 檔案保留供內部使用,其格式可能會因 Windows 不同版本而更改。