Ablaufverfolgungsebene

Ablaufverfolgungsebenen sind Eigenschaften eines Ablaufverfolgungsanbieters, z. B. 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 beliebige Bedingung zum Generieren der Ablaufverfolgungsnachricht darzustellen.

Im Gegensatz zu Ablaufverfolgungsflags, die vom Ablaufverfolgungsanbieter in der WPP_CONTROL_GUIDS-Struktur definiert werden, werden Ablaufverfolgungsebenen in Evntrace.h, einer öffentlichen Headerdatei, definiert. Der Ablaufverfolgungsanbieter interpretiert jedoch die Ebene und bestimmt deren Auswirkung.

Ablaufverfolgungsconsumer wie Tracelog und TraceView übergeben eine Ablaufverfolgungsebene an den Anbieter im EnableLevel-Parameter der EnableTrace-Funktion . Informationen zu EnableTrace finden Sie in der Dokumentation zu Microsoft Windows SDK.

Entwickler von Ablaufverfolgungsanbietern können auch benutzerdefinierte Ablaufverfolgungsfunktionen (Alternativen zu DoTraceMessage) schreiben, die die Ablaufverfolgungsebene als Bedingung zum Generieren der Ablaufverfolgungsnachricht einschließen. 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. Ablaufverfolgungsconsumer, z. B. Tracelog und TraceView, können Benutzer Parameter und Optionen festlegen, um die Ablaufverfolgungsflags und die Ablaufverfolgungsebene für jeden Anbieter in einer Ablaufverfolgungssitzung auszuwählen.

Wie bei Ablaufverfolgungsflags können Benutzer die Ablaufverfolgungsebene ändern, während eine Ablaufverfolgungssitzung ausgeführt wird, indem sie den Ablaufverfolgungsanbieter erneut abschreiben.