追蹤訊息格式檔案

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

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

您可以使用 Tracefmt 建立 TMF 檔案，並包含-i參數，以指示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 版本之間變更。