Dela via

Exempel 9: Skapa en TMF-fil

Följande kommando dirigerar Tracefmt till att formatera och visa spårningsmeddelandena i Tracedrv.etl, en spårningslogg som genereras av Tracedrv. TraceDrv, en exempeldrivrutin som har utformats för spårning av programvara, är tillgänglig på windows-drivrutinsprovlagringsplatsen på GitHub.

Kommandot innehåller parametern -i , som dirigerar Tracefmt till att skapa en TMF-fil för Tracedrv.

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

Kommandot använder parametern -i för att ange den fullständigt kvalificerade sökvägen till avbildningsfilen för Tracedrv, Tracedrv.sys, i WDK.

-i d:\tracedrv\tracedrv.sys

Den använder parametern -r för att ange den fullständigt kvalificerade sökvägen till den fullständiga versionen av PDB-symbolfilen för Tracedrv, Tracedrv.pdb. Observera att du anger en sökväg med den här parametern, men inte ett filnamn. Tracefmt hittar rätt version av symbolfilen baserat på den bildfil som anges av -i.

-r d:\tracedrv

Kommandot använder parametern -p för att dirigera Tracefmt för att placera den TMF-fil som skapas för Tracedrv i katalogen d:\tracedrv\tmfs .

-p d:\tracedrv\tmfs

Kommandot använder parametern -o för att dirigera Tracefmt för att placera utdatafilen för formaterade spårningsmeddelanden i filen d:\tracedrv\tracedrv1.txt . Den här parametern placerar även sammanfattningsfilen i samma katalog med filnamnet Tracedrv.txt.sum.

-o d:\tracedrv\tracedrv1.txt

Parametern -v begär detaljerade (utförliga) meddelanden.

Som svar på det här kommandot letar Tracefmt efter och hittar PDB-filen för Tracedrv.sys i katalogen d:\tracedrv. Den extraherar formateringsinstruktionerna för spårningsmeddelanden från PDB-filen och lagrar dem i en TMF-fil, enligt instruktionen i fetstil i utdata som följer. Namnet på TMF-filen är meddelandet GUID för spårningsprovidern i Tracedrv. Tracefmt skapar också en TMC-fil (Trace Message Control) och placerar den i samma katalog.

När Tracefmt har skapat TMF-filen läser den filen för att hitta formateringsanvisningarna för spårningsmeddelandena i spårningsloggen Tracedrv.etl. Den börjar med att titta i filen Default.tmf och hittar TMf-filen som den skapade i katalogen d:\tracedrv\tmfs.

Innan data formateras visar Tracefmt data om spårningsloggen. Data börjar med logfile d:\tracedrv\tracedrv.etl-instruktionen .

De sista instruktionerna i utdata visar att Tracefmt har formaterat de 13 händelserna i spårningsloggen och skapat filerna Tracedrv1.txt och Tracedrv1.txt.sum.

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

Det huvudsakliga resultatet från denna Tracefmt-körning är Tracedrv.txt, en textfil som innehåller den formaterade versionen av spårningsmeddelandena i Tracedrv.etl. Följande text visar innehållet i 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)
  • Last updated on