Livello di traccia

I livelli di traccia sono proprietà di un provider di traccia, ad esempio un driver in modalità kernel o un'applicazione in modalità utente. I livelli di traccia determinano gli eventi generati dal provider di traccia. In genere, il livello di traccia rappresenta la gravità dell'evento (informazioni, avvisi o errori), ma i provider di traccia possono definirli per rappresentare qualsiasi condizione per la generazione del messaggio di traccia.

A differenza dei flag di traccia, definiti dal provider di traccia nella struttura WPP_CONTROL_GUIDS , i livelli di traccia vengono definiti in Evntrace.h, un file di intestazione pubblica. Tuttavia, il provider di traccia interpreta il livello e ne determina l'effetto

I consumer di traccia, ad esempio Tracelog e TraceView, passano un livello di traccia al provider nel parametro EnableLevel della funzione EnableTrace . Per informazioni su EnableTrace, vedere la documentazione di Microsoft Windows SDK.

Gli sviluppatori di provider di traccia possono anche scrivere funzioni di traccia personalizzate (alternative a DoTraceMessage) che includono il livello di traccia come condizione per la generazione del messaggio di traccia. Per istruzioni, vedere È possibile personalizzare DoTraceMessage?

Quando si esegue una sessione di traccia, gli utenti possono usare il livello di traccia per determinare quali messaggi verranno generati durante la sessione. I consumer di traccia, ad esempio Tracelog e TraceView, consentono agli utenti di impostare parametri e opzioni per selezionare i flag di traccia e il livello di traccia per ogni provider in una sessione di traccia.

Analogamente ai flag di traccia, gli utenti possono modificare il livello di traccia durante l'esecuzione di una sessione di traccia ripristinando il provider di traccia.