Compartilhar via


!wmitrace.tmffile

A extensão !wmitrace.tmffile especifica um arquivo de formato de mensagem de rastreamento (TMF). O arquivo especificado por essa extensão é usado para formatar mensagens de rastreamento exibidas ou gravadas por outras extensões de rastreamento WMI.

!wmitrace.tmffile TMFFile 

Parâmetros

TMFFile
Especifica um arquivo de formato de mensagem de rastreamento.

DLL

Wmitrace.dll

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 "Arquivo de formato de mensagem de rastreamento" no Kit de Driver do Windows (WDK).

Comentários

Arquivos de formato de mensagem de rastreamento (.tmf) são arquivos de texto estruturados que são criados durante o rastreamento de software do Windows software software preprocessor (WPP). Esses arquivos contêm instruções para formatar mensagens de rastreamento binário de rastreamento para que eles possam ser exibidos em formato legível por humanos.

Para exibir a mensagem de rastreamento em um buffer de rastreamento (!wmitrace.logdump) ou gravá-la em um arquivo (!wmitrace.logsave), você deve primeiro identificar os arquivos TMF para as mensagens de rastreamento.

Você pode usar !wmitrace.searchpath para especificar um diretório no qual os arquivos TMF são armazenados. Em seguida, o sistema procura no diretório um arquivo TMF que contém instruções para as mensagens que ele está formatando. (Ele usa o GUID da mensagem para associar a mensagem ao arquivo TMF correto.)

No entanto, você pode usar !wmitrace.tmffile para especificar um arquivo TMF específico. Você deve usar !wmitrace.tmffile se o nome do arquivo TMF não for um GUID de mensagem seguido pela extensão .tmf. Caso contrário, o sistema não o encontrará.

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. 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.

Observação Se o driver usa UMDF versão 1.11 ou posterior, você não precisa usar !wmitrace.searchpath ou !wmitrace.tmffile.

Essa extensão só é útil durante o rastreamento de software WPP e métodos anteriores (legados) de rastreamento de eventos para Windows. Os eventos de rastreamento produzidos por outros provedores manifestados não usam arquivos TMF (formato de mensagem de rastreamento) e, portanto, essa extensão não pode ser usada com eles.