Partilhar via


Nível de rastreamento:

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

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 uma condição para gerar a mensagem de rastreamento. Para obter instruções, confira Posso personalizar o 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.

Assim como os sinalizadores de rastreamento, os usuários podem alterar o nível de rastreamento enquanto uma sessão de rastreamento está em execução por meio da nova inicialização do provedor de rastreamento.