Berichtvoorvoegsel traceren

Tracefmt voegt een voorvoegsel toe aan elk traceringsbericht dat bestaat uit gegevens die zijn opgeslagen in het bestand gebeurtenistraceringslogboekbestand (.etl) en het bestand traceringsberichtindeling (.tmf).

Tracefmt bevat standaard bepaalde gegevenselementen, maar gebruikers kunnen elementen toevoegen en verwijderen door de %TRACE_FORMAT_PREFIX% omgevingsvariabele te wijzigen, een tekenreeks die een berichtdefinitie opgeeft die compatibel is met FormatMessage.

De indeling van het standaardvoorvoegsel voor traceringsberichten is als volgt:

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

dat het volgende voorvoegsel produceert:

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

Elke %n variabele vertegenwoordigt een parameter die wordt beschreven in de volgende tabel.

Voorvoegselsvariabele-identificatie	Type variabele	Beschrijving
%1	touw	De vriendelijke naam van de bericht-GUID van het traceringsbericht. De vriendelijke naam van een bericht-GUID is standaard de naam van de map waarin de traceringsprovider is gebouwd. Als u de beschrijvende naam van de bericht-GUID wilt wijzigen, gebruikt u de parameter -p met Tracewpp of met de macro RUN_WPP. Zie Run_WPP Opties voor meer informatie.
%2	touw	Bronbestand en regelnummer. Deze variabele vertegenwoordigt de vriendelijke naam van het traceringsbericht. Standaard is de beschrijvende naam van een traceringsbericht de naam van het bronbestand en het regelnummer van de code die het traceringsbericht heeft gegenereerd.
%3	ULONG	Thread-id. Identificeert de thread die het traceringsbericht heeft gegenereerd.
%4	touw	Tijdstempel van de tijd waarop het traceringsbericht is gegenereerd.
%5	touw	Kerneltijd. Geeft de verstreken uitvoeringstijd weer voor kernelmodusinstructie, in CPU-tikken, op het moment dat het traceringsbericht is gegenereerd.
%6	touw	Gebruikerstijd. Geeft de verstreken uitvoeringstijd weer voor instructies in de gebruikersmodus, in CPU-tikken, op het moment dat het traceringsbericht is gegenereerd.
%7	LANG	Volgnummer. Geeft het lokale of globale volgnummer van het traceringsbericht weer. Lokale volgnummers, die alleen uniek zijn voor deze traceringssessie, zijn de standaardinstelling.
%8	ULONG	Proces-ID. Identificeert het proces dat het traceringsbericht heeft gegenereerd.
%9	ULONG	CPU-nummer. Identificeert de CPU waarop het traceringsbericht is gegenereerd.
%! FUNC!	touw	Functienaam. Geeft de naam weer van de functie die het traceringsbericht heeft gegenereerd.
%! VLAGGEN!	touw	Geeft de naam weer van de traceringsvlagmen die het traceringsbericht inschakelen. (Omdat de macro DoTraceMessage de vlaggen en niveau-argumenten omkeert, tonen berichten die door DoTraceMessage worden gegenereerd de waarde van het wafergeringsniveau in dit veld.)
%!NIVEAU!	touw	Geeft de waarde weer van het traceringsniveau waarmee het traceringsbericht wordt ingeschakeld. (Omdat de macro DoTraceMessage de markeringen en niveauargumenten omkeert, wordt in berichten die door DoTraceMessage worden gegenereerd de naam van de traceringsvlaggen weergegeven in dit veld.)
%!COMPNAME!	touw	Onderdeelnaam. Geeft de naam weer van het onderdeel van de provider die het traceringsbericht heeft gegenereerd. De onderdeelnaam wordt alleen weergegeven als deze is opgegeven in de traceringscode.
%! SUBCOMP!	touw	Subcomponentnaam. Geeft de naam weer van het subonderdeel van de provider die het traceringsbericht heeft gegenereerd. De onderdeelnaam wordt alleen weergegeven als deze is opgegeven in de traceringscode.

Het symbool tussen uitroeptekens is een conversieteken dat de opmaak en precisie van de variabele aangeeft. Bijvoorbeeld %8!04X! Hiermee geeft u de proces-ID op die wordt weergegeven als een hexadecimaal getal met vier niet-ondertekende tekens. Deze conversietekens moeten worden opgenomen.

Als u de elementen, volgorde of opmaak van het traceringsberichtvoorvoegsel wilt wijzigen, gebruikt u de omgevingsvariabele %TRACE_FORMAT_PREFIX%. Zie voor een voorbeeld Voorbeeld 7: Het voorvoegsel van het traceringsbericht aanpassen.

Voor een voorbeeld van inhoud in een TMF-bestand, zie Formatteringsspurberichten uit het tracedrv-voorbeeld.

Bovendien voegt de parameter -csv- een niet-geconfigureerd, gedetailleerd voorvoegsel toe aan elk traceringsbericht vóór het standaardvoorvoegsel Tracefmt. Gebruik de parameter -csvheader voor een beschrijving van de velden in het CSV-voorvoegsel.