!wmitrace.searchpath

Расширение !wmitrace.searchpath указывает расположение файлов формата сообщений трассировки для сообщений в буферах трассировки.

!wmitrace.searchpath [+] TMFPath 
!wmitrace.searchpath

Параметры

+
Приводит к добавлению TMFPath к существующему пути поиска. Если маркер плюса (+) не используется, TMFPath заменяет существующий путь поиска.

TMFPath
Путь к каталогу, в котором отладчик должен искать файлы формата сообщений трассировки. Пути, содержащие пробелы, не поддерживаются. Если включены несколько путей, они должны быть разделены точкой с запятой, и в кавычки должна быть заключена вся строка. Если путь находится в кавычках, символ обратной косой черты должен предшествовать escape-символу ( "c:\\debuggers;c:\\debuggers2" ). + При использовании маркера TMFPath будет добавлен к существующему пути с запятой, автоматически вставленной между существующим путем и новым путем. Однако, если + используется маркер, кавычки нельзя использовать.

DLL-библиотеки

Wmitrace.dll

Это расширение доступно в Windows 2000 и более поздних версиях Windows. Если вы хотите использовать это расширение с Windows 2000, сначала скопируйте файл Wmitrace.dll из подкаталога winxp каталога средств отладки для Windows в подкаталог w2kfre.

Дополнительная информация

Общие сведения о трассировке событий см. в пакете SDK для Microsoft Windows. Сведения о файлах формата сообщений трассировки см. в разделе "Файлы формата сообщений трассировки" в комплекте драйверов Windows (WDK).

Замечания

При использовании без параметров !wmitrace.searchpath отображает текущий путь поиска.

Файлы формата сообщений трассировки (*.tmf) содержат инструкции по форматированию сообщений двоичной трассировки, создаваемых поставщиком трассировки.

Параметр TMFPath должен содержать только путь к каталогу; он не может содержать имя файла. Имя файла TMF — это GUID сообщения, за которым следует расширение .tmf. Если система форматирует сообщение, он считывает GUID сообщения в сообщении и выполняет рекурсивный поиск по файлу TMF, имя которого соответствует GUID сообщения, начиная с указанного каталога.

Для форматирования двоичных сообщений трассировки в буфере требуется файл TMF. Используйте !wmitrace.searchpath или !wmitrace.tmffile , чтобы указать файл TMF перед использованием !wmitrace.dynamicprint или !wmitrace.logdump для отображения содержимого буфера трассировки.

Если вы не используете файл !wmitrace.searchpath или !wmitrace.tmffile, система использует значение переменной среды TRACE_FORMAT_SEARCH_PATH. Если эта переменная отсутствует, он использует файл default.tmf, который включен в Windows. Если система не может найти какие-либо сведения о форматировании для сообщения трассировки, она записывает сообщение об ошибке "Не найдено сведений о формате" вместо содержимого сообщения трассировки.