追蹤訊息格式檔案
追蹤訊息格式 (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 版本之間變更。