!wmitrace.logsave

A extensão !wmitrace.logsave grava o conteúdo atual dos buffers de rastreamento de uma sessão de rastreamento em um arquivo.

!wmitrace.logsave {LoggerID|LoggerName} Filename 

Parâmetros

LoggerID
Especifica a sessão de rastreamento. LoggerID é um número ordinal que o sistema atribui a cada sessão de rastreamento no computador.

LoggerName
Especifica a sessão de rastreamento. LoggerName é o nome de texto que foi especificado quando a sessão de rastreamento foi iniciada.

Filename
Especifica um caminho (opcional) e um nome de arquivo para o arquivo de saída.

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 o Tracelog, consulte "Tracelog" no Kit de Driver do Windows (WDK).

Comentários

Essa extensão exibe apenas os rastreamentos que estão na memória no momento. Ele não exibe mensagens de rastreamento que foram liberadas dos buffers e entregues a um arquivo de log de rastreamento de eventos ou a um consumidor de rastreamento.

Os buffers de sessão de rastreamento armazenam mensagens de rastreamento até que elas sejam liberadas para um arquivo de log ou para um consumidor de rastreamento para uma exibição em tempo real. Essa extensão salva o conteúdo dos buffers que estão na memória física para o arquivo especificado.

A saída é escrita em formato binário. Normalmente, esses arquivos usam a extensão de nome de arquivo .etl (log de rastreamento de eventos).

Quando você usa o Tracelog para iniciar uma sessão de rastreamento com buffer circular (-buffering), você pode usar essa extensão para salvar o conteúdo do buffer atual.

Para localizar a ID do agente de uma sessão de rastreamento, use a extensão !wmitrace.strdump. Como alternativa, você pode usar o comando tracelog tracelog -l para listar as sessões de rastreamento e suas propriedades básicas, incluindo a ID do agente.