Soubor souhrnné zprávy

Soubor souhrnné zprávy je textový soubor, který obsahuje informace o trasování softwaru. Tracefmt vytvoří soubor souhrnné zprávy (.sum) po zpracování zpráv v trasovacím protokolu nebo trasovací relaci.

Soubor souhrnné zprávy obsahuje do statistického souhrnu následující data:

• Počet zpracovaných vyrovnávacích pamětí

• Počet zpracovaných a ztracených zpráv

• Uplynulý čas v mikrosekundách relace trasování

Za statistickým souhrnem je tabulka, která se skládá z jednoho řádku pro každou trasovací zprávu obsaženou v trasování. Každý sloupec tabulky obsahuje následující informace o trasovací zprávě:

EventCount
Počet výskytů zprávy trasování v záznamu.

EventName
Popisný název identifikátoru GUID zpráv sledování. Ve výchozím nastavení je uživatelsky přívětivé jméno GUID zprávy název adresáře, ve kterém byl vytvořen poskytovatel trasování, ale můžete zadat alternativní uživatelsky přívětivé jméno pomocí parametru -p k RUN_WPP nebo Tracewpp.exe. Informace najdete v tématu Možnosti Run_WPP. (EventName má stejnou hodnotu jako proměnná %1 v předpona zprávy trasování.)

Typ události
Uživatelsky přívětivý název zprávy trasování Ve výchozím nastavení je přátelský název zprávy trasování název zdrojového souboru a číslo řádku ve zdrojovém kódu, který generuje zprávu trasování. (EventType má stejnou hodnotu jako proměnná %2 v předponě zprávy trasování.)

GUID
Identifikátor GUID zprávy trasování.

Následující příklad ukazuje soubor souhrnné zprávy pro protokol trasování testtrace.etl, který je generován Tracedrv, ukázkový ovladač instrumentovaný pro trasování. TraceDrv, ukázkový ovladač navržený pro trasování softwaru, je k dispozici v úložišti ukázek ovladačů pro Windows na GitHubu.

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

Předchozí souhrn ukazuje, že Tracedrv vygeneruje hlavičkovou zprávu a dvě trasovací zprávy. Jedna zpráva trasování je generována příkazem DoTraceMessage na řádku 264 a druhý je generován příkazem DoTraceMessage na řádku 258. V tomto protokolu trasování existuje 1700 instancí první zprávy trasování a 17 instancí druhé zprávy trasování.

Soubor souhrnné zprávy se používá především k ladění trasování softwaru a jeho formát se může změnit.