Nyomkövetési üzenet formátum fájl

A nyomkövetési üzenet formátuma (TMF) egy strukturált szövegfájl, amely utasításokat tartalmaz a nyomkövetési szolgáltató által létrehozott bináris nyomkövetési üzenetek elemzésére és formázására. A formázási utasításokat a nyomkövetési szolgáltató forráskódja tartalmazza, és a WPP-előfeldolgozó hozzáadja a nyomkövetési szolgáltató PDB-szimbólumfájljába.

Egyes, formázott nyomkövetési üzeneteket naplózó és megjelenítő eszközökhöz TMF-fájl szükséges. A nyomkövetési üzeneteket formázó és megjelenítő WDK-eszközök, a Tracefmt és a TraceView TMF-fájlokat használhatnak, vagy közvetlenül egy PDB-szimbólumfájlból kinyerhetik a formázási információkat.

TMF-fájlt a Tracefmt és az -i paraméter használatával hozhat létre, amely a Tracefmt-et egy TMF-fájl létrehozásához irányítja a Tracedrvhez. További információ : 9. példa: TMF-fájl létrehozása.

Ha nem rendelkezik nyomkövetési szolgáltatóhoz tartozó TMF-fájllal, használja a Tracepdb fájlt. A Tracepdb kinyeri a formázási utasításokat a PDB-szimbólumfájlból, és létrehoz egy TMF-fájlt a tárolásukhoz. Számos alkalmazás- és illesztőprogram-fejlesztő szívesebben szállít egy TMF-fájlt, mint egy PDB-szimbólumfájlt.

A TMF-fájl neve az adott TMF-fájlhoz társított üzenetek GUID azonosítója . Az ETW az üzenet GUID azonosítójával társít bizonyos nyomkövetési üzeneteket a formázási utasításokat tartalmazó TMF-fájlhoz.

A TMF-fájlok a következő adatokat tartalmazzák:

• Annak a PDB-fájlnak a neve, amelyből a TMF-fájl adatait kinyerték.

• A forrásfájlban lévő nyomkövetési üzenetek GUID-ja és a forrásfájl neve.

• Minden nyomkövetési üzenethez tartozik egy bejegyzés, amely megadja az üzenet típusát, a forráskód fájlnevét, egy sorszámot, egy üzenetszámot, egy üzenetdefiníciós sztringet, egy nyomkövetési jelző nevét és a makróhívást tartalmazó C függvény nevét.

• Azon változók listája, amelyek értékei megjelennek a nyomkövetési üzenetekben és a hozzájuk tartozó belső típusnevekben. A változókat egy üzenetdefiníciós sztring %n jelölése jelöli.

Jegyzet A TMF-fájl belső használatra van fenntartva, formátuma a Windows különböző verziói között változhat.