!wmitrace.logdump

A extensão !wmitrace.logdump exibe o conteúdo dos buffers de rastreamento para uma sessão de rastreamento. Você pode limitar a exibição para rastrear mensagens de provedores especificados.

!wmitrace.logdump [-t Count] [{LoggerID|LoggerName} [GUIDFile]] 

Parâmetros

-t Contar
Limita a saída às mensagens mais recentes. Count especifica o número de mensagens a serem exibidas.

ID do registrador
Especifica a sessão de rastreamento. LoggerID é um número ordinal que o sistema atribui a cada sessão de rastreamento no computador. Se nenhum parâmetro for especificado, a sessão de rastreamento com ID igual a 1 será usada.

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

GUIDFile
Exibe somente mensagens de rastreamento de provedores especificados no arquivo GUIDFile. GUIDFile representa o caminho (opcional) e o nome de um arquivo de texto que contém os GUIDs de controle de um ou mais provedores de rastreamento, como um arquivo .guid ou .ctl.

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

Durante o rastreamento de software WPP (pré-processador de rastreamento de software) do Windows, os buffers de sessão de rastreamento são usados para armazenar 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. A extensão !wmitrace.logdump exibe o conteúdo dos buffers que estão na memória física. A exibição aparece na janela Comando do Depurador.

Essa extensão é especialmente útil para recuperar os rastreamentos mais recentes quando ocorre uma falha e para exibir os rastreamentos armazenados em um arquivo de despejo de falha.

Antes de usar essa extensão, use !wmitrace.searchpath ou !wmitrace.tmffile para especificar os arquivos de formato de mensagem de rastreamento. O sistema usa os arquivos de formato de mensagem de rastreamento para formatar as mensagens de rastreamento binário nos buffers para que possam ser exibidas como texto legível por humanos.

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

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

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.

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 exibe o conteúdo.

Essa extensão é semelhante à extensão !wmitrace.eventlogdump, exceto que a saída de !wmitrace.logdump é formatada no estilo WPP, e a saída !wmitrace.eventlogdump é formatada no estilo de log de eventos. Você deve escolher a extensão cujo formato é apropriado para os dados que deseja exibir.

Para obter informações sobre como exibir o log de rastreamento UMDF, consulte Usar o rastreamento de software WPP em drivers baseados em UMDF.