Nyomkövetési üzenet fejlécfájlja

A nyomkövetési üzenetfejléc (TMH) egy szöveges fájl, amely a WPP által létrehozott nyomkövetési kód által használt függvények és változók deklarációit tartalmazza. A fejlécfájl olyan makrókat is tartalmaz, amelyek nyomkövetési üzenetformázási utasításokat adnak egy nyomkövetési szolgáltató PDB-fájljaihoz, például kernel módú illesztőprogramhoz vagy felhasználói módú alkalmazáshoz.

A WPP automatikusan létrehozza a TMH-fájlt, amikor WPP-makrókat tartalmazó nyomkövetési szolgáltatót állít össze. A TMH-fájl neve megegyezik a forrásfájl nevével, de .tmh fájlnévkiterjesztéssel. A WPP a fájlt a forrásfájllal megegyező könyvtárba menti.

Amikor hozzáadja a WPP-makrókat a forráskódhoz, hozzá kell adnia egy #include irányelvet is a WPP által létrehozott TMH-fájlhoz. A belefoglalási utasítás alakja:

#include SourceFileName.tmh

Ennek a belefoglalási utasításnak a WPP_CONTROL_GUIDS makró definíciója után, de a WPP-makrók hívása előtt kell megjelennie.

További információért lásd: WPP-makrók hozzáadása nyomkövetési adatforráshoz és TraceDrv, egy szoftverkövetéshez tervezett példaprogram. A TraceDrv-minta a GitHubOn található Windows-illesztőprogram-minták adattárában érhető el.