Compartilhar via


!wmitrace.searchpath

A extensão !wmitrace.searchpath especifica o local dos arquivos de formato de mensagem de rastreamento para mensagens nos buffers de rastreamento.

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

Parâmetros

+
Faz com que o TMFPath seja anexado ao caminho de pesquisa existente. Se o token de adição (+) não for usado, o TMFPath substituirá o caminho de pesquisa existente.

TMFPath
O caminho para o diretório onde o depurador deve procurar os arquivos de formato de mensagem de rastreamento. Não há suporte para caminhos que contêm espaços. Se vários caminhos forem incluídos, eles deverão ser separados por ponto e vírgula e a cadeia de caracteres inteira deverá ser colocada entre aspas. Se o caminho estiver entre aspas, o caractere de barra invertida deverá ser precedido por um caractere de escape ("c:\\debuggers;c:\\debuggers2"). Quando o token + é usado, o TMFPath será anexado ao caminho existente, com um ponto-e-vírgula inserido automaticamente entre o caminho existente e o novo caminho. No entanto, se o token + for usado, as aspas não poderão ser usadas.

DLL

Wmitrace.dll

Essa extensão está disponível no Windows 2000 e versões posteriores do Windows. Se você deseja usar essa extensão com o Windows 2000, você deve primeiro copiar o arquivo Wmitrace.dll do subdiretório winxp do diretório de instalação das Ferramentas de Depuração para Windows para o subdiretório w2kfre.

Informações Adicionais

Para obter uma visão geral conceitual do rastreamento de eventos, consulte o SDK do Microsoft Windows. Para obter informações sobre arquivos de formato de mensagem de rastreamento, consulte o tópico "Arquivos de formato de mensagem de rastreamento" no Kit de Driver do Windows (WDK).

Comentários

Quando usado sem parâmetros, !wmitrace.searchpath exibe o caminho de pesquisa atual.

Os arquivos de formato de mensagem de rastreamento (*.tmf) contêm instruções para formatar as mensagens de rastreamento binário geradas por um provedor de rastreamento.

O parâmetro TMFPath deve conter apenas um caminho para um diretório, ele não pode incluir um nome de arquivo. O nome de um arquivo TMF é um GUID de mensagem seguido pela extensão .tmf. Quando o sistema formata uma mensagem, ele lê a mensagem GUID na mensagem e procura recursivamente por um arquivo TMF cujo nome corresponde ao GUID da mensagem, começando no diretório especificado.

O Windows precisa de um arquivo TMF para formatar as mensagens de rastreamento binário em um buffer. Use !wmitrace.searchpath ou !wmitrace.tmffile para especificar o arquivo TMF antes de usar !wmitrace.dynamicprint ou !wmitrace.logdump para exibir o conteúdo do buffer de rastreamento.

Se você não usar !wmitrace.searchpath ou !wmitrace.tmffile, o sistema usará o valor da variável de ambiente TRACE_FORMAT_SEARCH_PATH. Se essa variável não estiver presente, ela usará o arquivo default.tmf, que está incluído no Windows. Se o sistema não conseguir localizar nenhuma informação de formatação para uma mensagem de rastreamento, ele gravará uma mensagem de erro "Nenhuma informação de formato encontrada" no lugar do conteúdo da mensagem de rastreamento.