跟踪消息格式文件

TMF) 文件的 跟踪消息格式 (是一个结构化文本文件，其中包含有关分析和设置 跟踪提供程序 生成的二进制跟踪消息格式的说明。 格式设置说明包含在跟踪提供程序的源代码中，并由 WPP 预处理器添加到跟踪提供程序的 PDB 符号文件中。

记录和显示格式化跟踪消息的某些工具需要 TMF 文件。 Tracefmt 和 TraceView 是设置跟踪消息格式并显示跟踪消息的 WDK 工具，可以使用 TMF 文件，也可以直接从 PDB 符号文件中提取格式设置信息。

可以使用 Tracefmt 并包含 -i 参数来创建 TMF 文件，该参数指示 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 而异。