Zusammenfassungsmeldungsdatei

Eine Zusammenfassungsmeldungsdatei ist eine Textdatei, die die Informationen zu einer Softwareablaufverfolgung enthält. Tracefmt erstellt eine Zusammenfassungsmeldungsdatei (.sum), nachdem die Nachrichten in einem Ablaufverfolgungsprotokoll oder einer Ablaufverfolgungssitzung verarbeitet wurden.

Die Zusammenfassungsmeldungsdatei enthält die folgenden Daten in einer statistischen Zusammenfassung:

• Die Anzahl der verarbeiteten Puffer

• Die Anzahl der verarbeiteten und verlorenen Nachrichten

• Die verstrichene Zeit der Ablaufverfolgungssitzung in Mikrosekunden

Nach der statistischen Zusammenfassung ist eine Tabelle, die aus einer Zeile für jede Ablaufverfolgungsnachricht besteht, die in der Ablaufverfolgung dargestellt wird. Jede Spalte der Tabelle enthält die folgenden Informationen zur Ablaufverfolgungsmeldung:

EventCount
Die Anzahl der Instanzen der Ablaufverfolgungsnachricht in der Ablaufverfolgung.

Eventname
Der Anzeigename der Nachrichten-GUID der Ablaufverfolgungsmeldungen. Standardmäßig ist der Anzeigename einer Nachrichten-GUID der Name des Verzeichnisses, in dem der Ablaufverfolgungsanbieter erstellt wurde. Sie können jedoch einen alternativen Anzeigenamen angeben, indem Sie den Parameter -p verwenden, um RUN_WPP oder Tracewpp.exe. Weitere Informationen finden Sie unter Run_WPP Optionen. (EventName hat den gleichen Wert wie die Variable %1 im Präfix der Ablaufverfolgungsnachricht.)

Eventtype
Der Anzeigename der Ablaufverfolgungsnachricht. Standardmäßig ist der Anzeigename einer Ablaufverfolgungsnachricht der Name der Quelldatei und die Zeilennummer des Codes, der die Ablaufverfolgungsnachricht generiert hat. (EventType hat den gleichen Wert wie die Variable %2 im Präfix der Ablaufverfolgungsnachricht.)

GUID
Die Nachrichten-GUID der Ablaufverfolgungsmeldungen.

Das folgende Beispiel zeigt eine Zusammenfassungsmeldungsdatei für das Ablaufverfolgungsprotokoll testtrace.etl, das von Tracedrv generiert wird, einem Beispieltreiber, der für die Ablaufverfolgung instrumentiert ist. TraceDrv, ein Beispieltreiber, der für die Softwareablaufverfolgung entwickelt wurde, ist im Repository für Windows-Treiberbeispiele auf GitHub verfügbar.

Files Processed:
d:\DDK Tools\tracetools\testtrace.etl
Total Buffers Processed 4
Total Events  Processed 1718
Total Events  Lost      4
Elapsed Time            122 sec
+---------------------------------------------------------------------------------+
|EventCount    EventName    EventType         Guid                                |
+---------------------------------------------------------------------------------+
|         1    Header       Header            68fdd900-4a3e-11d1-84f4-0000f80464e3|
|      1700    tracedrv     tracedrv_c264     37753236-c81f-505e-d40a-128d3bb2b5ff|
|        17    tracedrv     tracedrv_c258     37753236-c81f-505e-d40a-128d3bb2b5ff|
+---------------------------------------------------------------------------------+

Die obige Zusammenfassung zeigt, dass Tracedrv eine Headernachricht und zwei Ablaufverfolgungsmeldungen generiert. Eine Ablaufverfolgungsnachricht wird von einer DoTraceMessage-Anweisung in Zeile 264 generiert, und die andere wird von einer DoTraceMessage-Anweisung in Zeile 258 generiert. In diesem Ablaufverfolgungsprotokoll gibt es 1700 Instanzen der ersten Ablaufverfolgungsnachricht und 17 Instanzen der zweiten Ablaufverfolgungsnachricht.

Die Zusammenfassungsmeldungsdatei wird in erster Linie zum Debuggen der Softwareablaufverfolgung verwendet, und ihr Format kann sich ändern.