Tracepdb 命令

若要使用 Tracepdb，请在命令提示符窗口中键入命令。 以下语法显示 Tracepdb 命令的元素。

使用以下参数指定 PDB 文件的位置。

    tracepdb [-f PDBFiles] [-s] [-p TMFDirectory] [-v] [-c]

使用以下参数指定 跟踪提供程序的图像文件。

    tracepdb -i ImageFiles [-r SymbolPaths] [-p TMFDiretory]  [-v]

参数

-fPDBfiles
指定 PDB 符号文件的位置，这些文件是 Tracepdb 的输入。 本地目录中的默认值为 *.pdb。

PDBFiles 是一个或多个 PDB 文件的路径和文件名。 文件名可以包含通配符，例如表示多个字符的星号 (*) ，以及表示单个字符的问号 (？) 。 使用分号 (;) 分隔文件名。

-s
以递归方式搜索。 为目录中与 -f 参数的值匹配的所有 PDB 文件以及 -f 参数指定的路径的所有子目录创建 TMF 文件。 如果省略 -f ， 则 -s 会为本地目录及其子目录中的所有 PDB 文件创建 TMF 文件。

-pTMFDirectory
指定 Tracepdb 创建的 TMF 文件的位置。 默认值为本地目录。

TMF 文件是 Tracepdb 输出文件。 不能指定 TMF 文件的名称。 文件名是跟踪提供程序的消息 GUID。

-iImageFiles
指定 本地计算机上跟踪提供程序 的图像文件的位置。 使用 -i 参数时，Tracepdb 使用映像文件的名称和版本来查找其 PDB 符号文件。

ImageFiles 是跟踪提供程序的一个或多个二进制文件 (.exe、.dll.sys) 的路径和文件名。 ImageFiles 中的文件名可以包含通配符，例如 * (表示多个字符，) 和 ？ (表示单个字符) 。 使用分号 (;) 分隔图像文件名。

-rSymbolPaths
指定 PDB 符号文件的位置。

SymbolPaths 表示存储专用符号的目录或符号服务器上的目录的一个或多个路径。 SymbolPaths 中的路径名称可以包含通配符，例如 * (表示多个字符) 和 ？ (表示单个字符) 。

如果包含 -i 参数，但省略 -r，则 Tracepdb 将在 %_NT_SYMBOL_PATH% 环境变量指定的路径中搜索指定映像的 PDB 文件。 如果未设置环境变量，Tracepdb 将在默认符号路径 srv*\\\\symbols\\symbols 中搜索。

-V
显示详细输出。

-C
生成 TMC 文件。

示例

tracepdb -v
tracepdb -f tracedrv.pdb
tracepdb -f c:\tracing\ndis*.pdb -s
tracepdb -f d:\tools\trace*.pdb -p d:\tracing
tracepdb -i d:\winddk\7060\src\general\tracing\tracedrv\objfre_wnet_x86_vh\tracedrv.sys -r 
tracepdb -i trace*.exe;flpy*.dll -p d:\tracing
tracepdb -i tracedrv.exe -r srv*\\\\symbolstore\\symbols\\new

备注

TMF 文件的名称是源文件 的消息 GUID 。 消息 GUID 表示源文件和文件中的跟踪条目。 Windows 使用消息 GUID 将跟踪消息与包含消息格式设置说明的 TMF 文件相关联。

如果提交的 PDB 符号文件不包含跟踪格式设置说明，Tracepdb 将显示信息消息，并且不会创建任何文件。

如果 Tracefmt 在指定的路径中找不到任何 PDB 文件，它将返回到命令提示符，而不进行注释。 若要获取处理详细信息，请使用 -v 参数重新提交命令。