Nível de rastreio

Os níveis de rastreamento são propriedades de um provedor de rastreamento, como um driver de modo kernel ou um aplicativo de modo de usuário. Os níveis de rastreamento determinam quais eventos o provedor de rastreamento gera. Normalmente, o nível de rastreamento representa a gravidade do evento (informações, aviso ou erro), mas os provedores de rastreamento podem defini-los para representar qualquer condição para gerar a mensagem de rastreamento.

Ao contrário dos sinalizadores de rastreamento, que são definidos pelo provedor de rastreamento na estrutura WPP_CONTROL_GUIDS, os níveis de rastreamento são definidos em Evntrace.h, um arquivo de cabeçalho público. No entanto, o provedor de rastreamento interpreta o nível e determina seu efeito

Os consumidores de rastreamento , como Tracelog e TraceView, passam um nível de rastreamento para o provedor no parâmetro EnableLevel da função EnableTrace . Para obter informações sobre EnableTrace, consulte a documentação do SDK do Microsoft Windows.

Os desenvolvedores de provedores de rastreamento também podem escrever funções de rastreamento personalizadas (alternativas a DoTraceMessage) que incluem o nível de rastreamento como condição para gerar a mensagem de rastreamento. Para obter instruções, consulte Posso personalizar DoTraceMessage?

Ao executar uma sessão de rastreamento, os usuários podem usar o nível de rastreamento para determinar quais mensagens serão geradas durante a sessão. Os consumidores de rastreamento, como Tracelog e TraceView, permitem que os usuários definam parâmetros e opções para selecionar os sinalizadores de rastreamento e o nível de rastreamento para cada provedor em uma sessão de rastreamento.

Como sinalizadores de rastreamento, os usuários podem alterar o nível de rastreamento enquanto uma sessão de rastreamento está em execução reativando o provedor de rastreamento.