摘要消息文件

摘要消息文件是包含有关软件跟踪信息的文本文件。 在跟踪日志或跟踪会话中处理消息后，Tracefmt (.sum) 文件创建摘要 消息。

摘要消息文件在统计摘要中包含以下数据：

• 处理的缓冲区数

• 已处理和丢失的消息数

• 跟踪会话的运行时间（以微秒为单位）

在统计摘要之后是一个表，该表由跟踪中表示的每个跟踪消息的一行组成。 表的每一列提供有关跟踪消息的以下信息：

EventCount
跟踪中跟踪消息的实例数。

EventName
跟踪 消息的消息 GUID 的友好名称。 默认情况下，消息 GUID 的友好名称是在其中生成跟踪提供程序的目录的名称，但可以使用 -p 参数指定备用友好名称来RUN_WPP或Tracewpp.exe。 有关信息，请参阅Run_WPP选项。 (EventName 的值与 跟踪消息 prefix 中的 %1 变量相同。)

EventType
跟踪消息的友好名称。 默认情况下，跟踪消息的友好名称是源文件的名称和生成跟踪消息的代码的行号。 (EventType 的值与 跟踪消息 prefix 中的 %2 变量相同。)

Guid
跟踪消息的消息 GUID。

以下示例显示了由 Tracedrv 生成的 testtrace.etl 跟踪日志的摘要消息文件，Tracedrv 是一个针对跟踪检测的示例驱动程序。 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 个实例。

摘要消息文件主要用于调试软件跟踪，其格式可能会更改。