摘要消息文件

摘要消息文件是一个文本文件，其中包含有关软件跟踪的信息。 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 个实例。

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