摘要訊息檔案

摘要訊息檔案是包含軟體追蹤相關資訊的文字檔。 Tracefmt 會在處理追蹤記錄或追蹤會話中的訊息之後，建立 摘要訊息 (.sum) 檔案 。

摘要訊息檔案會在統計摘要中包含下列資料：

• 已處理的緩衝區數目

• 已處理和遺失的訊息數目

• 追蹤會話的經過時間，以毫秒為單位

在統計摘要之後，是一個資料表，其中包含追蹤中所代表之每個追蹤訊息的一個資料列。 資料表的每個資料行都會提供有關追蹤訊息的下列資訊：

EventCount
追蹤訊息在追蹤中的實例數目。

EventName
追蹤 訊息之訊息 GUID 的易記名稱。 根據預設，訊息 GUID 的易記名稱是建立追蹤提供者的目錄名稱，但您可以使用 -p 參數來指定替代的易記名稱來RUN_WPP或Tracewpp.exe。 如需詳細資訊，請參閱Run_WPP選項。 (EventName 的值與 追蹤訊息前置詞中的 %1 變數相同。)

EventType
追蹤訊息的易記名稱。 根據預設，追蹤訊息的易記名稱是來源檔案的名稱，以及產生追蹤訊息的程式程式碼號。 (EventType 的值與 追蹤訊息前置詞中的 %2 變數相同。)

Guid
追蹤訊息的訊息 GUID。

下列範例顯示由 Tracedrv 產生的 testtrace.etl 追蹤記錄檔摘要訊息檔案，這是針對追蹤檢測的範例驅動程式。 TraceDrv是專為軟體追蹤設計的範例驅動程式，可從 GitHub 上的 Windows 驅動程式範例 存放庫取得。

Files Processed:
d:\DDK Tools\tracetools\testtrace.etl
Total Buffers Processed 4
Total Events  Processed 1718
Total Events  Lost      4
Elapsed Time            122 sec
+---------------------------------------------------------------------------------+
|EventCount    EventName    EventType         Guid                                |
+---------------------------------------------------------------------------------+
|         1    Header       Header            68fdd900-4a3e-11d1-84f4-0000f80464e3|
|      1700    tracedrv     tracedrv_c264     37753236-c81f-505e-d40a-128d3bb2b5ff|
|        17    tracedrv     tracedrv_c258     37753236-c81f-505e-d40a-128d3bb2b5ff|
+---------------------------------------------------------------------------------+

上述摘要顯示 Tracedrv 會產生標頭訊息和兩個追蹤訊息。 一個追蹤訊息是由第 264 行上的 DoTraceMessage 語句所產生，另一個則是由第 258 行上的 DoTraceMessage 語句所產生。 在此追蹤記錄檔中，第一個追蹤訊息有 1700 個實例，以及第二個追蹤訊息的 17 個實例。

摘要訊息檔案主要用於偵錯軟體追蹤，而且其格式可能會變更。