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

  • Статья

Файл формата сообщений трассировки (TMF) — это структурированный текстовый файл, содержащий инструкции по анализу и форматированию двоичных сообщений трассировки, создаваемых поставщиком трассировки . Инструкции по форматированию включаются в исходный код поставщика трассировки и добавляются в PDB-файл 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-файлом. Трассировка событий Windows использует GUID сообщения для связывания определенных сообщений трассировки с файлом TMF, в котором содержатся инструкции по форматированию.

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

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

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

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

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

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