!wmitrace.searchpath

!wmitrace.searchpath 扩展指定消息跟踪消息格式文件在跟踪缓冲区中的位置。

!wmitrace.searchpath [+] TMFPath 
!wmitrace.searchpath

参数

+
促使将 TMFPath 追加到现有搜索路径。 如果未使用加号 (+) 令牌，TMFPath 将替换现有的搜索路径。

TMFPath
调试器应查找跟踪消息格式文件所在的目录路径。 包含空格的路径不受支持。 如果包含多个路径，则应用分号分隔这些路径，并且应用引号将整个字符串引起来。 如果路径以引号表示，反斜杠字符前面必须有转义字符 ( "c:\\debuggers;c:\\debuggers2" )。 使用 + 令牌时，会将 TMFPath 追加到现有路径，并且会自动在现有路径和新路径之间插入分号；但是，如果使用 + 令牌，则无法使用引号。

DLL

Wmitrace.dll

此扩展在 Windows 2000 及更高版本的 Windows 中可用。 如果要将此扩展与 Windows 2000 配合使用，必须先将 Windows 调试工具安装目录的 winxp 子目录中的 Wmitrace.dll 文件复制到 w2kfre 子目录。

其他信息

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

注解

不使用任何参数时，!wmitrace.searchpath 将显示当前搜索路径。

跟踪消息格式文件 (*.tmf) 包含有关设置跟踪提供程序生成的二进制跟踪消息的格式的说明。

TMFPath 参数必须仅包含目录的路径，而不能包含文件名。 TMF 文件的名称是消息 GUID，后跟 .tmf 扩展名。 当系统设置消息格式时，它会读取消息上的消息 GUID，并以递归方式搜索名称与消息 GUID 匹配的 TMF 文件，从指定目录开始。

Windows 需要 TMF 文件才能设置缓冲区中的二进制跟踪消息的格式。 使用 !wmitrace.searchpath 或 !wmitrace.tmffile 指定 TMF 文件，然后再使用 !wmitrace.dynamicprint 或 !wmitrace.logdump 显示跟踪缓冲区内容。

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