Präfix für Ablaufverfolgungsnachrichten
Tracefmt fügt jeder Ablaufverfolgungsnachricht ein Präfix hinzu, die aus Daten besteht, die in der Etl-Datei (Ereignisablaufverfolgungsprotokoll) und der Ablaufverfolgungsnachrichtenformatdatei (.tmf) gespeichert sind.
Tracefmt enthält standardmäßig bestimmte Datenelemente, aber Benutzer können Elemente hinzufügen und entfernen, indem sie die Umgebungsvariable %TRACE_FORMAT_PREFIX% ändern, eine Zeichenfolge, die eine mit FormatMessage kompatible Nachrichtendefinition angibt.
Das Format des Standardpräfixes für Ablaufverfolgungsnachrichten lautet wie folgt:
[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]
das folgende Präfix erzeugt:
[CPUNumber]ProcessID.ThreadID :: SystemTime [MessageGUIDFriendlyName]
Jede %n-Variable stellt einen Parameter dar, der in der folgenden Tabelle beschrieben wird.
| Bezeichner von Präfixvariablen | Variablentyp | Beschreibung |
|---|---|---|
%1 |
Zeichenfolge |
Der Anzeigename der Nachrichten-GUID der Ablaufverfolgungsnachricht. Standardmäßig ist der Anzeigename einer Nachrichten-GUID der Name des Verzeichnisses, in dem der Ablaufverfolgungsanbieter erstellt wurde. Um den Anzeigenamen der Nachrichten-GUID zu ändern, verwenden Sie den Parameter -p mit Tracewpp oder mit dem RUN_WPP Makro. Weitere Informationen finden Sie unter Run_WPP Optionen. |
%2 |
Zeichenfolge |
Quelldatei und Zeilennummer. Diese Variable stellt den Anzeigenamen der Ablaufverfolgungsnachricht dar. Standardmäßig ist der Anzeigename einer Ablaufverfolgungsnachricht der Name der Quelldatei und die Zeilennummer des Codes, der die Ablaufverfolgungsnachricht generiert hat. |
%3 |
ULONG |
Thread-ID. Gibt den Thread an, der die Ablaufverfolgungsmeldung generiert hat. |
%4 |
Zeichenfolge |
Zeitstempel der Zeit, zu der die Ablaufverfolgungsnachricht generiert wurde. |
%5 |
Zeichenfolge |
Kernelzeit. Zeigt die verstrichene Ausführungszeit für Kernelmodusanweisungen in CPU-Ticks zum Zeitpunkt der Generierung der Ablaufverfolgungsmeldung an. |
%6 |
Zeichenfolge |
Benutzerzeit. Zeigt die verstrichene Ausführungszeit für Benutzermodusanweisungen in CPU-Ticks zum Zeitpunkt der Generierung der Ablaufverfolgungsmeldung an. |
%7 |
LONG |
Sequenznummer. Zeigt die lokale oder globale Sequenznummer der Ablaufverfolgungsnachricht an. Lokale Sequenznummern, die nur für diese Ablaufverfolgungssitzung eindeutig sind, sind die Standardnummer. |
%8 |
ULONG |
Prozess-ID. Identifiziert den Prozess, der die Ablaufverfolgungsnachricht generiert hat. |
%9 |
ULONG |
CPU-Nummer. Gibt die CPU an, auf der die Ablaufverfolgungsmeldung generiert wurde. |
%! FUNC! |
Zeichenfolge |
Funktionsname Zeigt den Namen der Funktion an, die die Ablaufverfolgungsmeldung generiert hat. |
%! FLAGGEN! |
Zeichenfolge |
Zeigt den Namen der Ablaufverfolgungsflags an , die die Ablaufverfolgungsmeldung aktivieren. (Da das DoTraceMessage-Makro die Flags und Ebenenargumente umkehrt, zeigen von DoTraceMessage generierte Nachrichten den Wert der Ablaufverfolgungsebene in diesem Feld an.) |
%! EBENE! |
Zeichenfolge |
Zeigt den Wert der Ablaufverfolgungsebene an , die die Ablaufverfolgungsmeldung aktiviert. (Da das DoTraceMessage-Makro die Flags und Ebenenargumente umkehrt, zeigen von DoTraceMessage generierte Nachrichten den Namen der Ablaufverfolgungsflags in diesem Feld an.) |
%! COMPNAME! |
Zeichenfolge |
Komponentenname Zeigt den Namen der Komponente des Anbieters an, der die Ablaufverfolgungsmeldung generiert hat. Der Komponentenname wird nur angezeigt, wenn er im Ablaufverfolgungscode angegeben ist. |
%! SUBCOMP! |
Zeichenfolge |
Unterkomponentenname. Zeigt den Namen des Unterkomponenten des Anbieters an, der die Ablaufverfolgungsmeldung generiert hat. Der Komponentenname wird nur angezeigt, wenn er im Ablaufverfolgungscode angegeben ist. |
Das Symbol in Ausrufezeichen ist ein Konvertierungszeichen, das die Formatierung und Genauigkeit der Variablen angibt. Beispiel: %8!04X! gibt die Prozess-ID an, die als vierstellige hexadezimale Zahl ohne Vorzeichen dargestellt wird. Diese Konvertierungszeichen müssen enthalten sein.
Verwenden Sie die Umgebungsvariable %TRACE_FORMAT_PREFIX%, um die Elemente, die Reihenfolge oder die Formatierung des Präfixes der Ablaufverfolgungsnachricht zu ändern. Ein Beispiel finden Sie unter Beispiel 7: Anpassen des Präfix der Ablaufverfolgungsnachricht.
Ein Beispiel für Inhalte in einer TMF-Datei finden Sie unter Formatieren von Ablaufverfolgungsmeldungen aus dem tracedrv-Beispiel.
Außerdem fügt der -csv-Parameter jeder Ablaufverfolgungsnachricht vor dem Standardpräfix Tracefmt ein nicht konfigurierbares, detailliertes Präfix hinzu. Verwenden Sie für eine Beschreibung der Felder im CSV-Präfix den Parameter -csvheader .