追蹤層級

追蹤層級是 追蹤提供者的屬性,例如核心模式驅動程式或使用者模式應用程式。 追蹤層級會決定追蹤提供者產生的事件。 一般而言,追蹤層級代表事件 (資訊、警告或錯誤) 的嚴重性,但追蹤提供者可以定義它們來代表產生追蹤訊息的任何條件。

不同于 追蹤旗標,這些旗標是由 WPP_CONTROL_GUIDS 結構中的追蹤提供者所定義,追蹤層級是在 Evntrace.h 中定義,這是公用標頭檔。 不過,追蹤提供者會解譯層級並判斷其效果

追蹤取用者,例如TracelogTraceView,會將追蹤層級傳遞至EnableTrace函式的EnableLevel參數中的提供者。 如需EnableTrace的相關資訊,請參閱Microsoft Windows SDK檔。

追蹤提供者的開發人員也可以撰寫自訂追蹤函式, (DoTraceMessage) 的替代方案,其中包含追蹤層級作為產生追蹤訊息的條件。 如需指示,請參閱 是否可以自訂 DoTraceMessage?

執行追蹤會話時,使用者可以使用追蹤層級來判斷會話期間將產生哪些訊息。 追蹤取用者,例如 TracelogTraceView,可讓使用者設定參數和選項,以選取追蹤會話中每個提供者的追蹤旗標和追蹤層級。

如同追蹤旗標,使用者可以藉由重新啟用追蹤提供者,在追蹤會話執行時變更追蹤層級。