Plik komunikatu podsumowania

Plik komunikatów podsumowania to plik tekstowy zawierający informacje o śladzie programowym. Narzędzie Tracefmt tworzy plik podsumowania wiadomości (.sum) po przetworzeniu komunikatów w dzienniku śledzenia lub sesji śledzenia.

Plik komunikatu podsumowania zawiera następujące dane w podsumowaniu statystycznym:

• Liczba przetworzonych buforów

• Liczba przetworzonych i utraconych komunikatów

• Czas trwania sesji śledzenia, wyrażony w mikrosekundach

Po podsumowaniu statystycznym znajduje się tabela, która składa się z jednego wiersza dla każdego komunikatu śledzenia przedstawionego w śladzie. Każda kolumna tabeli zawiera następujące informacje dotyczące komunikatu śledzenia:

EventCount
Liczba wystąpień komunikatu śledzenia w śladzie.

EventName
Przyjazna nazwa identyfikatora GUID komunikatów śladu. Domyślnie przyjazna nazwa identyfikatora GUID komunikatu to nazwa katalogu, w którym zbudowano dostawcę śledzenia, ale można określić alternatywną przyjazną nazwę, używając parametru -p w poleceniu RUN_WPP lub Tracewpp.exe. Aby uzyskać informacje, zobacz opcje Run_WPP. (EventName ma taką samą wartość jak zmienna %1 w prefiksie komunikatu śledzenia).

EventType
Przyjazna nazwa komunikatu śledzenia. Domyślnie przyjazna nazwa komunikatu śledzenia to nazwa pliku źródłowego i numer wiersza kodu, który wygenerował komunikat śledzenia. (Typ zdarzenia ma taką samą wartość jak zmienna %2 w prefiksie komunikatu śledzenia).

identyfikator GUID
Identyfikator GUID komunikatów śledzenia.

W poniższym przykładzie przedstawiono plik komunikatu podsumowania dziennika śledzenia testtrace.etl, który jest generowany przez tracedrv, przykładowy sterownik instrumentowany do śledzenia. TraceDrv, przykładowy sterownik przeznaczony do śledzenia oprogramowania, jest dostępny w repozytorium przykładów sterowników systemu Windows w witrynie GitHub.

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|
+---------------------------------------------------------------------------------+

Powyższe podsumowanie pokazuje, że tracedrv generuje komunikat nagłówka i dwa komunikaty śledzenia. Jeden komunikat śledzenia jest generowany przez instrukcję DoTraceMessage w wierszu 264, a druga jest generowana przez instrukcję DoTraceMessage w wierszu 258. W tym dzienniku śledzenia istnieje 1700 wystąpień pierwszego komunikatu śledzenia i 17 wystąpień drugiego komunikatu śledzenia.

Plik komunikatów podsumowania jest używany głównie do debugowania śledzenia oprogramowania, a jego format może ulec zmianie.