通过

!wmitrace.tmffile

  • 项目

!wmitrace.tmffile 扩展指定跟踪消息格式 (TMF) 文件。 此扩展指定的文件用于设置其他 WMI 跟踪扩展显示或写入的跟踪消息的格式。

!wmitrace.tmffile TMFFile

参数

TMFFile
指定跟踪消息格式文件。

DLL

Wmitrace.dll

其他信息

有关事件跟踪的概念性概述，请参阅 Microsoft Windows SDK。 有关跟踪消息格式文件的信息，请参阅 Windows 驱动程序工具包 (WDK) 中的“跟踪消息格式文件”主题。

注解

跟踪消息格式文件 (.tmf) 是在 Windows 软件跟踪预处理器 (WPP) 软件跟踪期间创建的结构化文本文件。 这些文件包含有关设置跟踪二进制跟踪消息格式的说明，以便可以以人工可读的形式显示这些消息。

要在跟踪缓冲区中显示跟踪消息 (!wmitrace.logdump)，或将其写入文件 (!wmitrace.logsave)，必须先标识跟踪消息的 TMF 文件。

可以使用 !wmitrace.searchpath 指定存储 TMF 文件的目录。 然后，系统会在目录中搜索包含其格式消息的说明的 TMF 文件。 （它使用消息 GUID 将消息与正确的 TMF 文件相关联。）

但是，可以使用 !wmitrace.tmffile 指定特定的 TMF 文件。 如果 TMF 文件名不是消息 GUID，后跟 .tmf 扩展名，则必须使用 !wmitrace.tmffile。 否则，系统将找不到它。

如果未使用 !wmitrace.searchpath 或 !wmitrace.tmffile，则系统会使用 TRACE_FORMAT_SEARCH_PATH 环境变量的值。 如果该变量不存在，则使用 default.tmf 文件。 如果系统找不到跟踪消息的格式信息，则会写入“未找到格式信息”错误消息，而不是跟踪消息内容。

注意 如果驱动程序使用 UMDF 版本 1.11 或更高版本，则无需使用 !wmitrace.searchpath 或 !wmitrace.tmffile。

此扩展仅在 WPP 软件跟踪和 Windows 事件跟踪的早期（旧版）方法期间有用。 由其他清单提供程序生成的跟踪事件不使用跟踪消息格式 (TMF) 文件，因此不能将此扩展与它们配合使用。