Общие сведения о Tracepdb

Поставщики трассировки, такие как приложения пользовательского режима и драйверы в режиме ядра, хранят свои сообщения трассировки в двоичной форме для повышения эффективности. Чтобы прочитать сообщения трассировки, необходимо применить инструкции по форматированию, указанные для каждого сообщения трассировки в коде поставщика трассировки.

Препроцессор WPP извлекает инструкции форматирования из кода поставщика трассировки и добавляет их в PDB-файлы символов для поставщика трассировки.

Tracepdb извлекает инструкции по форматированию из полной или частной версии файла символов PDB для поставщика трассировки (инструкции по форматированию трассировки удаляются из общедоступных файлов символов) и создает файлы формата сообщений трассировки (TMF) для каждого поставщика трассировки в исходном коде. TMF-файлы — это текстовые файлы, содержащие только инструкции по форматированию для сообщений трассировки поставщика.

Средства, отображающие сообщения трассировки в удобочитаемом формате, такие как TraceView и Tracefmt, используют TMF-файлы для анализа и форматирования сообщений трассировки. Кроме того, вы можете распространять TMF-файлы среди пользователей вместо частных файлов символов.

Tracepdb создает MOF-файл (MOF-файл), содержащий GUID элемента управления и уровни трассировки каждого поставщика трассировки, представленного в PDB-файле. Имя MOF-файла — это имя модуля поставщика трассировки.

Tracepdb также может создать файл элемента управления сообщением трассировки (TMC) для каждого поставщика трассировки в исходном коде, если используется параметр -c . Файл TMC содержит GUID элемента управления и уровни трассировки каждого поставщика трассировки, представленного в PDB-файле. Имя файла TMC — это GUID элемента управления поставщика трассировки. Вы должны заботиться о файле TMC, только если вы будете использовать Traceview без PDB-файла.

Единственная функция Tracepdb — создание файлов TMF. Однако другие средства, такие как BinPlace, TraceView и Tracefmt, создают TMF-файлы в дополнение к другим функциям. Использование Tracepdb эквивалентно использованию команды binplace -:tmf , команды traceview -parsepdb и tracefmt -i .

В системах, предшествующих Windows Vista, tracepdb требует mspdb70.dll и msvcr70.dll. Если эти файлы находятся не в том же каталоге, что и файл Tracepdb.exe, переместите их перед использованием Tracepdb.

В системах, предшествующих Windows Vista, необходимо скопировать файл Dbghelp.dll из подкаталога bin\<Platform> пакета драйверов Windows (WDK) (где <платформа>— x86, amd64 или ia64) в каталог, в котором находится Tracefmt.exe.

Дополнительные сведения о трассировке событий см. в документации по Windows SDK. Сведения об использовании трассировки событий в драйверах в режиме ядра и приложениях в пользовательском режиме см. в разделе Трассировка программного обеспечения WPP.