Beispiel 7: Anpassen des Präfixes für die Ablaufverfolgungsnachricht

Jede Ablaufverfolgungsnachricht beginnt mit einem Ablaufverfolgungsnachrichtenpräfix , das aus Daten zur Ablaufverfolgungsnachricht besteht. Das Format des Ablaufverfolgungsnachrichtenpräfixes wird in der Umgebungsvariable %TRACE_FORMAT_PREFIX% gespeichert. Durch Ändern des Werts der Umgebungsvariablen können Sie das Präfix der Ablaufverfolgungsmeldung anpassen, um die daten, die Sie zur Ablaufverfolgungsnachricht benötigen, in dem für Sie nützlichsten Format anzuzeigen. Die Variablen im Standardpräfix für Ablaufverfolgungsnachrichten und alle Variablen, die Sie in einem Ablaufverfolgungsnachrichtenpräfix verwenden können, werden im Thema Präfix für Ablaufverfolgungsnachrichten beschrieben.

Die folgende Anzeige zeigt das Standardpräfix der Ablaufverfolgungsmeldung. Die Ablaufverfolgungsmeldungen wurden von Tracedrv generiert, dem ablaufverfolgungsfähigen Beispieltreiber im Windows Driver Kit (WDK).

[0]0AF4.0C64::07/25/2003-14:55:39.998 [tracedrv]IOCTL = 1
[0]0AF4.0C64::07/25/2003-14:55:39.998 [tracedrv]Hello, 1 Hi
[0]0AF4.0C64::07/25/2003-14:55:39.998 [tracedrv]Hello, 2 Hi
...

Das Format des Standardpräfixes lautet wie folgt.

[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]

Dies stellt die folgenden Daten dar:

[CPUNumber]ProcessID.ThreadID::SystemTime [MessageGUIDFriendlyName]

Dabei ist MessageGUIDFriendlyName standardmäßig der Name des Verzeichnisses, in dem der Ablaufverfolgungsanbieter erstellt wurde.

Verwenden Sie zum Erstellen eines neuen Ablaufverfolgungsnachrichtenpräfixes den Befehl set , um den Wert der Umgebungsvariable %TRACE_FORMAT_PREFIX% zurückzusetzen. Beispiel:

set TRACE_FORMAT_PREFIX=%2!s!: %!FUNC!: %8!04x!.%3!04x!: %4!s!:

Dieser Befehl legt das Präfix der Ablaufverfolgungsmeldung im folgenden Format fest:

SourceFile_LineNumber: FunctionName: ProcessID.ThreadID: SystemTime 

Daher verwendet die Tracefmt-Ausgabe das neue Ablaufverfolgungsnachrichtenpräfix, wie in der folgenden Anzeige gezeigt:

tracedrv_c258: TracedrvDispatchDeviceControl: 0af4.0c64: 07/25/2003-13:55:39.998:  IOCTL = 1
tracedrv_c264: TracedrvDispatchDeviceControl: 0af4.0c64: 07/25/2003-13:55:39.998:  Hello, 1 Hi
tracedrv_c264: TracedrvDispatchDeviceControl: 0af4.0c64: 07/25/2003-13:55:39.998:  Hello, 2 Hi
tracedrv_c264: TracedrvDispatchDeviceControl: 0af4.0c64: 07/25/2003-13:55:39.998:  Hello, 3 Hi

...

Hinweis Wenn Sie das Ablaufverfolgungspräfix in einer Befehls- oder Batchdatei festlegen, wobei das Prozentsymbol eine Variable für einen Befehlszeilenparameter darstellt, verwenden Sie zwei aufeinander folgende Prozentsymbole für die Präfixvariablen. Um beispielsweise die Systemzeit in das Präfix einzuschließen, geben Sie %%4 ein.