Файл формата сообщения трассировки

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

Некоторым средствам, которые регистрируют и отображают отформатированные сообщения трассировки, требуется файл TMF. Tracefmt и TraceView, средства WDK, которые форматируют и отображают сообщения трассировки, могут использовать файл TMF или извлекать сведения о форматировании непосредственно из файла символов PDB.

Файл TMF можно создать с помощью Tracefmt и в том числе параметра -i , который направляет Tracefmt для создания файла TMF для Tracedrv. Дополнительные сведения см. в примере 9. Создание файла TMF.

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

Имя файла TMF — это GUID сообщения сообщений, связанных с этим файлом TMF. ETW использует GUID сообщения для ассоциирования определенных событий трассировки с файлом TMF, который содержит их инструкции по форматированию.

Файл TMF содержит следующие данные:

• Имя PDB-файла, из которого извлекаются данные файла TMF.

• GUID сообщения для сообщений трассировки в исходном файле, а также имя самого исходного файла.

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

• Список переменных, значения которых отображаются в сообщениях трассировки, и соответствующие внутренние имена типов. Переменные представлены нотацией %n в строке определения сообщения.

Заметка Файл TMF зарезервирован для внутреннего использования, и его формат подлежит изменению между различными версиями Windows.