Soubor formátování trasovacích zpráv

Soubor formátu zprávy trasování (TMF) je strukturovaný textový soubor, který obsahuje pokyny k analýze a formátování binárních trasovacích zpráv, které generuje zprostředkovatel trasování . Pokyny k formátování jsou zahrnuty ve zdrojovém kódu zprostředkovatele trasování a jsou přidány do souboru symbolů PDB zprostředkovatele trasování pomocí preprocesoru WPP.

Některé nástroje, které protokolují a zobrazují formátované zprávy trasování, vyžadují soubor TMF. Tracefmt a TraceView, nástroje WDK, které formátují a zobrazují zprávy trasování, mohou použít soubor TMF nebo mohou extrahovat informace o formátování přímo ze souboru symbolů PDB.

Soubor TMF můžete vytvořit pomocí Tracefmt a včetně parametru -i , který směruje Tracefmt k vytvoření souboru TMF pro Tracedrv. Další informace najdete v tématu Příklad 9: Vytvoření souboru TMF.

Pokud nemáte soubor TMF pro zprostředkovatele trasování, použijte Tracepdb. Tracepdb extrahuje pokyny k formátování ze souboru symbolů PDB a vytvoří soubor TMF pro jejich uložení. Mnoho vývojářů aplikací a ovladačů dává přednost odeslání souboru TMF místo souboru symbolu PDB.

Název souboru TMF je identifikátor GUID zprávy přidružené k danému souboru TMF. ETW používá GUID zprávy k přidružení konkrétních trasovacích zpráv k souboru TMF, který obsahuje pokyny k formátování.

Soubor TMF obsahuje následující data:

• Název souboru PDB, ze kterého se extrahovala data souboru TMF.

• Identifikátor GUID zpráv trasování ve zdrojovém souboru a název zdrojového souboru.

• Pro každou trasovací zprávu existuje položka, která určuje typ zprávy, název souboru zdrojového kódu, číslo řádku, číslo zprávy, řetězec definice zprávy, název příznaku trasy a název funkce jazyka C, která obsahuje volání makra.

• Seznam proměnných, jejichž hodnoty se zobrazují v trasovacích zprávách a jejich přidružených interních názvech typů. Proměnné jsou reprezentovány pomocí %n notací v definičním řetězci zprávy.

Poznámka Soubor TMF je vyhrazený pro interní použití a jeho formát se může měnit mezi různými verzemi Windows.