跟踪消息格式文件

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

记录和显示格式化跟踪消息的某些工具需要 TMF 文件。 用于格式化和显示跟踪消息的 WDK 工具 TracefmtTraceView 可以使用 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 之间可能会更改。