了解 Tracefmt

跟踪提供程序 以二进制形式记录跟踪消息以提高效率。 若要以可读形式显示跟踪消息,Tracefmt 将应用每条消息的格式设置说明,然后显示消息或将它们保存在文本文件中。

小提示

TraceView 提供了与 Tracefmt 相同的功能,并提供易于使用的 GUI。

跟踪消息的格式说明包含在使用 WPP 软件跟踪的跟踪提供程序的源代码中,然后编译为跟踪提供程序的 PDB 符号文件的专用或完整版本。 WPP 预处理器从专用符号中提取格式化指令,并将其放入跟踪消息格式 (.tmf) 文件中,以供提供程序使用。

若要设置跟踪消息的格式,Tracefmt 需要 TMF 文件。 您可以将 TMF 文件提供给 Tracefmt,或指示 Tracefmt 为您创建一个 TMF 文件。 使用以下任一方法提供所需的输入。

使用 Default.tmf。 由于大多数应用程序和驱动程序都使用标准消息格式,因此可以使用 Default.tmf 中的信息设置其消息的格式,该文件包含在 WDK 中。

提供 TMF 文件。 可以通过提供特定 TMF 文件的路径和文件名来指定它。

提供 TMF 文件目录的路径。 Tracefmt 可以使用跟踪消息的 message GUID,在 TMF 文件目录中识别包含消息格式说明的 TMF 文件。 TMF 文件名由消息 GUID 加上 .tmf 扩展名组成。

指示 Tracefmt 创建一个 TMF 文件。 Tracefmt 可以使用图像文件(.exe、.dll或 .sys)来查找目录中跟踪提供程序的专用 PDB 符号文件,或使用内部符号服务器。 然后,它根据 PDB 文件中的数据创建 TMF 文件,并使用 TMF 文件设置跟踪消息的格式。 创建 TMF 文件时,Tracepdb 创建一个 MOF (.mof) 文件,该文件包含 PDB 文件中表示的每个跟踪提供程序的控制 GUID 和跟踪级别。 MOF 文件的名称是跟踪提供程序的模块名称。

设置跟踪消息的格式后,Tracefmt 可以在命令行上显示跟踪消息,并且可以创建以下文件:

  • 格式化跟踪消息的输出文件。 消息按跟踪提供程序生成的顺序显示。 每条消息前面有一个跟踪前缀。 有关信息,请参阅跟踪消息前缀

  • 摘要消息文件 包含有关生成跟踪消息时的跟踪会话的信息

有关事件跟踪的详细信息,请参阅 Microsoft Windows SDK 文档。 有关在驱动程序中使用事件跟踪的信息,请参阅 WPP 软件跟踪