Пример 3. Указание файла TMF

В этом примере демонстрируются методы указания TMF-файла, используемого для форматирования сообщений трассировки:

• Используйте параметр -tmf .

  Следующая команда использует параметр -tmf для указания пути и имени файла TMF. Путь переопределяет любую другую спецификацию пути TMF.

  tracefmt mytrace.etl -tmf c:\tracing\37753236-c81f-505e-d40a-128d3bb2b5ff.tmf
  

  Tracefmt использует указанный TMF-файл для форматирования сообщений трассировки в файле mytrace.etl.

• Используйте параметр -p .

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

  tracefmt mytrace.etl -p c:\tracing
  

  Tracefmt использует указанный TMF-файл для форматирования сообщений трассировки в файле mytrace.etl.

• Используйте %TRACE_FORMAT_SEARCH_PATH%.

  Первая команда в этом ряду задает для переменной среды %TRACE_FORMAT_SEARCH_PATH% расположение каталога, в данном случае c:\tracing.

  В следующей за ней команде Tracefmt параметры -tmf и -p опущены.

  set TRACE_FORMAT_SEARCH_PATH=c:\tracing
  tracefmt mytrace.etl
  

  Хотя ни путь, ни каталог не указаны в команде Tracefmt, Tracefmt выполняет поиск TMF-файла в каталоге c:\trace, а затем использует содержимое для форматирования сообщений трассировки в файле mytrace.etl.

Если TMF-файлы, указанные каким-либо из этих методов, не содержат инструкций по форматированию для сообщений трассировки, TraceView записывает сообщение в выходной файл с сообщением об ошибке "Сведения о формате не найдены". Пример:

Unknown( 10): GUID=37753236-c81f-505e-d40a-128d3bb2b5ff (No Format Information found).
Unknown( 11): GUID=37753236-c81f-505e-d40a-128d3bb2b5ff (No Format Information found).
Unknown( 11): GUID=37753236-c81f-505e-d40a-128d3bb2b5ff (No Format Information found).
...