Beispiel 5: Formatierung Real-Time Ablaufverfolgungssitzungen

Sie können Tracefmt verwenden, um Ablaufverfolgungsmeldungen aus Echtzeitablaufverfolgungssitzungen zusätzlich zu Ablaufverfolgungsprotokolldateien zu formatieren.

Die folgende Befehlssequenz verwendet Tracelog und Tracefmt. Der erste Befehl verwendet Tracelog, um eine Echtzeitablaufverfolgungssitzung mit dem Tracedrv-Beispielablaufverfolgungsanbieter zu starten. TraceDrv, ein Beispieltreiber, der für die Softwareablaufverfolgung entwickelt wurde, ist im Repository für Windows-Treiberbeispiele auf GitHub verfügbar.

tracelog -start MyTrace -guid tracedrv.ctl -flag 1 -rt

Mit diesem Befehl wird eine Ablaufverfolgungssitzung namens MyTrace gestartet. Er verwendet den -guid-Parameter , um den Ablaufverfolgungsanbieter zu identifizieren, Tracedrv.sys mithilfe seiner Steuerelement-GUID-Datei tracedrv.ctl. Er verwendet den - flag-Parameter , um den Wert des Ablaufverfolgungsflags auf 1 festzulegen. Er verwendet den -rt-Parameter , um eine Ablaufverfolgungssitzung zu starten, die Nachrichten direkt an einen Ablaufverfolgungs-Consumer übermittelt, z. B. Tracefmt. Ohne den - rt-Parameter sendet der Ablaufverfolgungsanbieter Nachrichten nur an eine Protokolldatei.

Der nächste Befehl verwendet Tracefmt, um die von Tracedrv während der MyTrace-Ablaufverfolgungssitzung generierten Nachrichten zu formatieren.

tracefmt -rt MyTrace -p c:\tracing -o mytrace.txt

Dieser Tracefmt-Befehl verwendet den Parameter -rt , um die Echtzeitablaufverfolgungssitzung, MyTrace, und den Parameter -p zu identifizieren, um das Verzeichnis anzugeben, in dem sich die TMF-Datei für Tracedrv.sys befindet. Der -o-Parameter leitet die Ausgabe an die mytrace.txt Datei im lokalen Verzeichnis weiter.

Als Reaktion auf diesen Befehl bereitet Tracefmt das Formatieren der Ablaufverfolgungsmeldungen in Echtzeit vor. Es werden die folgenden status Meldungen angezeigt, aber nicht zur Eingabeaufforderung zurückgegeben:

c:\tracetools>tracefmt -rt mytrace -display -o mytrace.txt
Setting RealTime mode for  mytrace
Getting guids from c:\tracetools\default.tmf

Der folgende Tracelog-Befehl beendet die MyTrace-Ablaufverfolgungssitzung. Sie müssen den Befehl in einem anderen Eingabeaufforderungsfenster eingeben.

tracelog -stop mytrace

Wenn die Ablaufverfolgungssitzung beendet wird, meldet Tracefmt, dass die Ablaufverfolgungsmeldungen in die Ausgabedatei geschrieben wurden, und kehrt dann zur Eingabeaufforderung zurück.

Event traces dumped to mytrace.txt
Event Summary dumped to mytrace.txt.sum