通过

!wmitrace.logdump

  • 项目

!wmitrace.logdump 扩展显示跟踪会话的跟踪缓冲区内容。 可以将显示限制为跟踪来自指定提供程序的消息。

!wmitrace.logdump [-t Count] [{LoggerID|LoggerName} [GUIDFile]]

参数

-t 计数
将输出限制为最新消息。 Count 指定要显示的消息数。

LoggerID
指定跟踪会话。 LoggerID 是系统分配给计算机上的每个跟踪会话的序号。 如果未指定任何参数，则使用 ID 等于 1 的跟踪会话。

LoggerName
指定跟踪会话。 LoggerName 是启动跟踪会话时指定的文本名称。

GUIDFile
仅显示来自 GUIDFile 文件中指定的提供程序的跟踪消息。 GUIDFile 表示包含一个或多个跟踪提供程序的控制 GUID 的文本文件的路径（可选）和文件名，例如 .guid 或 .ctl 文件。

DLL

Wmitrace.dll

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

其他信息

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

注解

在 Windows 软件跟踪预处理器 (WPP) 软件跟踪期间，跟踪会话缓冲区用于存储跟踪消息以供实时显示，直到将跟踪消息刷新到日志文件或跟踪使用者。 !wmitrace.logdump 扩展显示物理内存中的缓冲区内容。 显示内容将显示在“调试器命令”窗口中。

此扩展特别适用于在发生崩溃时恢复最新跟踪，并显示存储在故障转储文件中的跟踪。

使用此扩展之前，请使用 !wmitrace.searchpath 或 !wmitrace.tmffile 指定跟踪消息格式文件。 系统使用跟踪消息格式文件设置缓冲区中的二进制跟踪消息的格式，以便将其显示为人工可读文本。

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

使用 Tracelog 启动具有循环缓冲的跟踪会话时 (-buffering)，请使用此扩展来显示缓冲区内容。

要查找跟踪会话的记录器 ID，请使用 !wmitrace.strdump 扩展。 或者，可以使用 Tracelog 命令 tracelog -l 列出跟踪会话及其基本属性，包括记录器 ID。

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

此扩展类似于 !wmitrace.eventlogdump 扩展，只是 !wmitrace.logdump 的输出采用 WPP 样式的格式，而 !wmitrace.eventlogdump 的输出采用事件日志样式的格式。 应选择适合要显示的数据的格式的扩展。

有关如何查看 UMDF 跟踪日志的信息，请参阅在基于 UMDF 的驱动程序中使用 WPP 软件跟踪。