Compartilhar via


!wmitrace.dynamicprint

A extensão !wmitrace.dynamicprint controla se o depurador exibe as mensagens de rastreamento geradas por uma sessão em execução no KD_FILTER_MODE.

!wmitrace.dynamicprint {0 | 1}

Parâmetros

0
Desativa a exibição da mensagem de rastreamento.

1
Ativa a exibição da mensagem de rastreamento.

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 ajuda para iniciar uma sessão de rastreamento, consulte "Tracelog" no WDK (Kit de Driver do Windows).

Comentários

Antes de usar essa extensão, inicie uma sessão de rastreamento e especifique que as mensagens de rastreamento devem ser enviadas ao depurador. Por exemplo, se você usar !wmitrace.start para iniciar a sessão, use o parâmetro -kd. Se você usar o Tracelog para iniciar a sessão de rastreamento, use seu parâmetro -kd. Tracelog (tracelog.exe) é um controlador de rastreamento incluído no Windows Driver Kit.

As mensagens de rastreamento são mantidas em um buffer no computador de destino. Esses buffers são liberados e enviados ao depurador no computador host em intervalos regulares. Você pode especificar o intervalo de temporizador de liberação usando o parâmetro -kd do comando !wmitrace.start, ou o parâmetro -kd da ferramenta Tracelog. A partir do Windows 8, você pode especificar o valor do temporizador de liberação em milissegundos anexando ms ao valor do temporizador de liberação.

Por padrão, o ETW mantém buffers de rastreamento por processador no computador de destino. Quando os buffers de rastreamento são liberados e enviados ao depurador no computador host, não há nenhum mecanismo para mesclar os buffers em uma sequência cronológica de eventos. Assim, os eventos podem ser exibidos fora de ordem. A partir do Windows 7, você pode resolver esse problema definindo o parâmetro -lowcapacity ao usar a ferramenta Tracelog para iniciar uma sessão de rastreamento.

Tracelog MySession -kd -lowcapacity

Quando você inicia uma sessão com -lowcapacity definido, todos os eventos vão para um único buffer no computador de destino e os eventos são exibidos na ordem correta no depurador no computador host.

Além disso, 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 para que possam ser exibidas como texto legível por humanos.

Confira também

!wmitrace.start