示例 3:指定 TMF 文件

此示例演示指定用于设置跟踪消息格式的 TMF 文件的方法:

  • 使用 -tmf 参数。

    以下命令使用 -tmf 参数指定 TMF 文件的路径和文件名。 该路径将替代任何其他 TMF 路径规范。

    tracefmt mytrace.etl -tmf c:\tracing\37753236-c81f-505e-d40a-128d3bb2b5ff.tmf
    

    Tracefmt 使用指定的 TMF 文件来格式化 mytrace.etl 文件中的跟踪消息。

  • 使用 -p 参数。

    以下命令使用 -p 参数指定 TMF 文件所在的目录。 Tracefmt 将跟踪提供程序的控件 GUID 与 TMF 文件名匹配,以查找正确的 TMF 文件。 这样,用户就不必复制或键入繁琐的 GUID 文件名。

    tracefmt mytrace.etl -p c:\tracing
    

    Tracefmt 使用指定的 TMF 文件来格式化 mytrace.etl 文件中的跟踪消息。

  • 使用 %TRACE_FORMAT_SEARCH_PATH%。

    此系列中的第一个命令将 %TRACE_FORMAT_SEARCH_PATH% 环境变量的值设置为目录位置,在本例中为 c:\tracing。

    在紧随其后的 Tracefmt 命令中,省略 -tmf-p 参数。

    set TRACE_FORMAT_SEARCH_PATH=c:\tracing
    tracefmt mytrace.etl
    

    尽管 Tracefmt 命令中未指定路径和目录,但 Tracefmt 在 c:\tracing 目录中搜索 TMF 文件,然后使用内容设置 mytrace.etl 文件中的跟踪消息的格式。

如果上述任一方法指定的 TMF 文件不包含跟踪消息的格式设置说明, TraceView 会将消息写入输出文件,并显示“找不到格式信息”错误消息。 例如:

Unknown( 10): GUID=37753236-c81f-505e-d40a-128d3bb2b5ff (No Format Information found).
Unknown( 11): GUID=37753236-c81f-505e-d40a-128d3bb2b5ff (No Format Information found).
Unknown( 11): GUID=37753236-c81f-505e-d40a-128d3bb2b5ff (No Format Information found).
...