Поделиться через

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

  • Статья

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

Совет

TraceView предоставляет те же функции, что и Tracefmt с более простым графическим интерфейсом.

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

Для форматирования сообщений трассировки Tracefmt требуется файл TMF. Файл TMF можно предоставить Tracefmt или direct Tracefmt, чтобы создать для вас файл TMF. Используйте любой из следующих методов для предоставления необходимых входных данных.

Используйте Default.tmf. Так как большинство приложений и драйверов используют стандартные форматы сообщений, их сообщения можно отформатировать с помощью сведений в Default.tmf, файла, включенного в WDK.

Укажите файл TMF. Можно указать конкретный файл TMF, указав путь и имя файла.

Укажите путь к каталогу файлов TMF. Tracefmt может использовать GUID сообщения для сообщений трассировки для идентификации файла TMF, содержащего инструкции по форматированию сообщения в каталоге файлов TMF. Имена файлов TMF состоят из GUID сообщения с расширением TMF-файла.

Direct Tracefmt для создания файла TMF. Tracefmt может использовать файл изображения (.exe, .dll или .sys) для поставщика трассировки, чтобы найти частный файл символов PDB для поставщика трассировки в каталоге или с помощью внутреннего сервера символов. Затем он создает файл TMF из данных в PDB-файле и использует TMF-файл для форматирования сообщений трассировки. При создании файла TMF Tracepdb создает MOF-файл (MOF), содержащий GUID элемента управления и уровни трассировки каждого поставщика трассировки, представленные в PDB-файле. Имя MOF-файла — это имя модуля поставщика трассировки.

После форматирования сообщений трассировки Tracefmt может отобразить сообщения трассировки в командной строке и создать следующие файлы:

  • Выходной файл отформатированных сообщений трассировки. Сообщения отображаются в том порядке, в который они были созданы поставщиком трассировки. Перед каждым сообщением предшествует префикс трассировки. Дополнительные сведения см. в разделе Префикс сообщения трассировки.

  • Файл сводного сообщения о сеансе трассировки, во время которого были созданы сообщения трассировки.

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