Příklad 9: Vytvoření souboru TMF

Následující příkaz přikazuje Tracefmtu zformátovat a zobrazit trasovací zprávy v souboru Tracedrv.etl, což je trasovací protokol vygenerovaný programem Tracedrv. TraceDrv, ukázkový ovladač navržený pro trasování softwaru, je k dispozici v úložišti ukázek ovladačů pro Windows na GitHubu.

Příkaz obsahuje parametr -i , který směruje Tracefmt k vytvoření souboru TMF pro Tracedrv.

tracefmt d:\tracedrv\tracedrv.etl -i d:\tracedrv\tracedrv.sys -r d:\tracedrv 
-p d:\tracedrv\tmfs -o d:\tracedrv\tracedrv1.txt -v

Příkaz používá parametr -i k označení plně kvalifikované cesty k souboru obrázku pro Tracedrv, Tracedrv.sys, v WDK.

-i d:\tracedrv\tracedrv.sys

Pomocí parametru -r označuje plně kvalifikovanou cestu k plné verzi souboru symbolů PDB pro Tracedrv, Tracedrv.pdb. Všimněte si, že pomocí tohoto parametru zadáte cestu, ale ne název souboru. Tracefmt najde správnou verzi souboru symbolů na základě souboru obrázku určeného parametrem -i.

-r d:\tracedrv

Příkaz pomocí parametru -p směruje Tracefmt k umístění souboru TMF, který vytvoří pro Tracedrv v adresáři d:\tracedrv\tmfs .

-p d:\tracedrv\tmfs

Příkaz pomocí parametru -o směruje Tracefmt k umístění výstupního souboru formátovaných zpráv trasování do souboru d:\tracedrv\tracedrv1.txt . Tento parametr také umístí souhrnný soubor do stejného adresáře s názvem souboru Tracedrv.txt.sum.

-o d:\tracedrv\tracedrv1.txt

Parametr -v požaduje podrobné zprávy.

V reakci na tento příkaz tracefmt vyhledá a vyhledá soubor PDB pro Tracedrv.sys v adresáři d:\tracedrv. Extrahuje instrukce pro formátování trasovací zprávy ze souboru PDB a uloží je do souboru TMF, jak je znázorněno v příkazu tučným písmem ve výstupu, který následuje. Název souboru TMF je GUID zprávy poskytovatele trasování v Tracedrv. Tracefmt také vytvoří soubor řízení trasovacích zpráv (TMC) a umístí ho do stejného adresáře.

Jakmile Tracefmt vytvoří soubor TMF, přečte soubor a vyhledá pokyny k formátování trasovacích zpráv v protokolu trasování Tracedrv.etl. Začne hledáním v souboru Default.tmf a vyhledá soubor TMf, který vytvořil v adresáři d:\tracedrv\tmfs.

Před formátováním dat nástroj Tracefmt zobrazí data o protokolu trasování. Data začínají příkazem Logfile d:\tracedrv\tracedrv.etl .

Konečné příkazy ve výstupu ukazují, že Tracefmt úspěšně naformátoval 13 událostí v protokolu trasování a vytvořil Tracedrv1.txt a Tracedrv1.txt.sum souborů.

Setting log file to: d:\tracedrv\tracedrv.etl

Searching for matching PDB to d:\tracedrv\tracedrv.sys
Current Symbol Search Path = d:\tracedrv

Extracting TMF files out of found PDB files
DBGHELP: d:\tracedrv\tracedrv.pdb - OK
tracefmt : info BNP0000: WPPFMT generating d:\tracedrv\tmfs\1606d1a7-1682-57d1-65f7-36693800e096.tmf for d:\tracedrv\tracedrv.pdb
tracefmt : info BNP0000: WPPFMT generating d:\tracedrv\tmfs\d58c126f-b309-11d1-969e-0000f875a5bc.tmc for d:\tracedrv\tracedrv.pdb
Examining C:\WinDDK\5066\tools\tracing\i386\default.tmf for message formats,  3 found.
Searching for TMF files on path: d:\tracedrv\tmfs
Logfile d:\tracedrv\tracedrv.etl:
        OS version              5.1.2600  (Currently running on 5.1.2600)
        Start Time              2005-06-10-14:25:30.827
        End Time                2005-06-10-14:26:14.371
        Timezone is             Pacific Standard Time (Bias is 480mins)
        BufferSize              8192 B
        Maximum File Size       0 MB
        Buffers  Written        2
        Logger Mode Settings    (0) Logfile Mode is not set
        ProcessorCount          1
06/10/2005-21:25:45.539 ::        1: Filled=     696, Lost=  0 TotalLost= 0

Processing completed   Buffers: 1, Events: 13, EventsLost: 0 :: Format Errors: 0, Unknowns: 0

Event traces dumped to d:\tracedrv\tracedrv1.txt
Event Summary dumped to d:\tracedrv\tracedrv1.txt.sum

Primární výstup tohoto spuštění Tracefmt je Tracedrv.txt, textový soubor, který obsahuje formátovanou verzi trasovacích zpráv v Tracedrv.etl. Následující text zobrazuje obsah Tracedrv.txt .

EventTrace
[0]0338.0E40::06/10/2005-14:25:43.968 [tracedrv]IOCTL = 1
[0]0338.0E40::06/10/2005-14:25:43.968 [tracedrv]Hello, 1 Hi
[0]0338.0E40::06/10/2005-14:25:43.968 [tracedrv]Hello, 2 Hi
[0]0338.0E40::06/10/2005-14:25:43.968 [tracedrv]Hello, 3 Hi
[0]0338.0E40::06/10/2005-14:25:43.968 [tracedrv]Machine State :: Offline
[0]0338.0E40::06/10/2005-14:25:43.968 [tracedrv]Function Return=0x8000000f(STATUS_DEVICE_POWERED_OFF)
[0]0338.0E40::06/10/2005-14:25:45.539 [tracedrv]IOCTL = 2
[0]0338.0E40::06/10/2005-14:25:45.539 [tracedrv]Hello, 1 Hi
[0]0338.0E40::06/10/2005-14:25:45.539 [tracedrv]Hello, 2 Hi
[0]0338.0E40::06/10/2005-14:25:45.539 [tracedrv]Hello, 3 Hi
[0]0338.0E40::06/10/2005-14:25:45.539 [tracedrv]Machine State :: Offline
[0]0338.0E40::06/10/2005-14:25:45.539 [tracedrv]Function Return=0x8000000f(STATUS_DEVICE_POWERED_OFF)