Nyomkövetési üzenet előtagja

A Tracefmt egy előtagot ad hozzá minden nyomkövetési üzenethez, amely az eseménykövetési naplófájlban (.etl) tárolt adatokból és a nyomkövetési üzenet formátumából (.tmf) álló fájlból áll.

A Tracefmt alapértelmezés szerint bizonyos adatelemeket tartalmaz, de a felhasználók hozzáadhatnak és eltávolíthatnak elemeket a %TRACE_FORMAT_PREFIX% környezeti változó módosításával, amely egy , a FormatMessage-vel kompatibilis üzenetdefiníciót meghatározó sztring.

Az alapértelmezett nyomkövetési üzenetelőtag formátuma a következő:

[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]

amely a következő előtagot hozza létre:

[CPUNumber]ProcessID.ThreadID :: SystemTime [MessageGUIDFriendlyName]

Minden %n változó az alábbi táblázatban leírt paramétert jelöli.

Előtagváltozó azonosítója	Változó típusa	Leírás
%1	szál	A nyomkövetési üzenet üzenet GUID-jának barátságos neve. Alapértelmezés szerint az üzenet GUID barátságos neve annak a könyvtárnak a neve, amelyben a nyomkövetési szolgáltató készült. Az üzenet GUID barátságos nevének módosításához használja a -p paramétert a Tracewpp vagy a RUN_WPP makróval. További információ: Run_WPP Beállítások.
%2	szál	Forrásfájl és sorszám. Ez a változó a nyomkövetési üzenet rövid nevét jelöli. Alapértelmezés szerint a nyomkövetési üzenet rövid neve a forrásfájl neve és a nyomkövetési üzenetet létrehozó kód sorszáma.
%3	ULONG	Szálazonosító. Azonosítja a nyomkövetési üzenetet létrehozó szálat.
%4	szál	A nyomkövetési üzenet létrehozásának időbélyege.
%5	szál	Kernelidő. Megjeleníti a kernel módú utasítások végrehajtásához eltelt időt CPU ciklusokban, abban az időpontban, amikor a nyomkövetési üzenet létrejött.
%6	szál	Felhasználói idő. A felhasználói módú utasításokhoz eltelt végrehajtási időt jeleníti meg CPU-osztásokban, a nyomkövetési üzenet létrehozásakor.
%7	HOSSZÚ	Sorozatszáma. Megjeleníti a nyomkövetési üzenet helyi vagy globális sorszámát. Ebben a nyomkövetési munkamenetben az egyedi helyi sorszámok az alapértelmezettek.
%8	ULONG	Folyamatazonosító. Azonosítja a nyomkövetési üzenetet létrehozó folyamatot.
%9	ULONG	CPU-szám. Azonosítja azt a processzort, amelyen a nyomkövetési üzenet létrejött.
%!FUNC!	szál	Függvény neve. Megjeleníti a nyomkövetési üzenetet létrehozó függvény nevét.
%!ZÁSZLÓK!	szál	Megjeleníti a nyomkövetési üzenetet engedélyező nyomkövetési jelzők nevét. (Mivel a DoTraceMessage makró megfordítja a jelzőket és a szintargumentumokat, a DoTraceMessage által létrehozott üzenetek a mező nyomkövetési szintjének értékét jelenítik meg.)
%! SZINT!	szál	Megjeleníti a nyomkövetési üzenetet engedélyező nyomkövetési szint értékét. (Mivel a DoTraceMessage makró megfordítja a jelzőket és a szintargumentumokat, a DoTraceMessage által létrehozott üzenetek a mező nyomkövetési jelzőinek nevét jelenítik meg.)
%! COMPNAME!	szál	Összetevő neve. Megjeleníti a nyomkövetési üzenetet létrehozó szolgáltató összetevőjének nevét. Az összetevő neve csak akkor jelenik meg, ha a nyomkövetési kódban van megadva.
%!SUBCOMP!	szál	Alkomponens neve. Megjeleníti a nyomkövetési üzenetet létrehozó szolgáltató alösszetevőjének nevét. Az összetevő neve csak akkor jelenik meg, ha a nyomkövetési kódban van megadva.

A felkiáltójeleken belüli szimbólum egy konverziós karakter, amely meghatározza a változó formázását és pontosságát. Például %8!04X! A folyamatazonosítót négyjegyű, aláíratlan hexadecimális számként adja meg. Ezeket a konvertálási karaktereket is tartalmaznia kell.

A nyomkövetési üzenet előtagjának elemeinek, sorrendjének vagy formázásának módosításához használja a %TRACE_FORMAT_PREFIX% környezeti változót. Példa: 7. példa: A nyomkövetési üzenet előtagjának testreszabása.

Egy TMF-fájl tartalmára példa: Nyomkövetési üzenetek formázása a tracedrv-mintából.

A -csv paraméter emellett egy konfigurálhatatlan, részletes előtagot ad hozzá az egyes nyomkövetési üzenetekhez a standard Tracefmt előtag előtt. A CSV-előtag mezőinek leírásához használja a -csvheader paramétert.