Ablaufverfolgungsebene

Verfolgungsebenen sind Eigenschaften eines Ablaufverfolgungsanbieters, wie eines Kernelmodustreibers oder einer Benutzermodusanwendung. Ablaufverfolgungsebenen bestimmen, welche Ereignisse der Ablaufverfolgungsanbieter generiert. In der Regel stellt die Ablaufverfolgungsebene den Schweregrad des Ereignisses (Informationen, Warnung oder Fehler) dar, aber Ablaufverfolgungsanbieter können sie definieren, um eine bedingung für die Generierung der Ablaufverfolgungsmeldung darzustellen.

Im Gegensatz zu Ablaufverfolgungskennzeichnungen, die vom Ablaufverfolgungsanbieter in der WPP_CONTROL_GUIDS Struktur definiert werden, werden Ablaufverfolgungsebenen in Evntrace.h, einer öffentlichen Headerdatei, definiert. Der Ablaufverfolgungsanbieter interpretiert jedoch das Level und bestimmt dessen Wirkung.

Trace-Consumer wie Tracelog und TraceView übergeben eine Protokollebene an den Anbieter über den EnableLevel-Parameter der EnableTrace-Funktion. Informationen zu EnableTrace finden Sie in der Microsoft Windows SDK-Dokumentation.

Entwickler von Ablaufverfolgungsanbietern können auch benutzerdefinierte Ablaufverfolgungsfunktionen (Alternativen zu DoTraceMessage) schreiben, die die Ablaufverfolgungsebene als Bedingung zum Generieren der Ablaufverfolgungsnachricht enthalten. Anweisungen finden Sie unter "Kann ich DoTraceMessage anpassen?

Beim Ausführen einer Ablaufverfolgungssitzung können Benutzer die Ablaufverfolgungsebene verwenden, um zu bestimmen, welche Nachrichten während der Sitzung generiert werden. Mithilfe von Trace-Consumern, z. B. Tracelog und TraceView, können Benutzer Parameter und Optionen festlegen, um die Trace-Flags und das Trace-Level für jeden Anbieter in einer Tracing-Sitzung auszuwählen.

Indem der Ablaufverfolgungsanbieter erneut aktiviert wird, können Benutzer, wie bei Ablaufverfolgungskennzeichnungen, die Ablaufverfolgungsebene ändern, während eine Ablaufverfolgungssitzung ausgeführt wird.