Prefisso messaggio di traccia

Tracefmt aggiunge un prefisso a ogni messaggio di traccia costituito da dati archiviati nel file del log di traccia eventi (con estensione etl) e dal file di formato del messaggio di traccia (con estensione tmf).

Tracefmt include elementi dati specifici per impostazione predefinita, ma gli utenti possono aggiungere e rimuovere elementi modificando la variabile di ambiente %TRACE_FORMAT_PREFIX%, una stringa che specifica una definizione di messaggio compatibile con FormatMessage.

Il formato del prefisso del messaggio di traccia predefinito è il seguente:

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

che produce il prefisso seguente:

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

Ogni variabile %n rappresenta un parametro descritto nella tabella seguente.

Identificatore di variabile del prefisso	Tipo di variabile	Descrizione
%1	string	Nome descrittivo del GUID del messaggio di traccia. Per impostazione predefinita, il nome descrittivo di un GUID del messaggio è il nome della directory in cui è stato compilato il provider di traccia . Per modificare il nome descrittivo del GUID del messaggio, usare il parametro -p con Tracewpp o con la macro RUN_WPP. Per altre informazioni, vedere opzioni di Run_WPP.
%2	string	File di origine e numero di riga. Questa variabile rappresenta il nome descrittivo del messaggio di traccia. Per impostazione predefinita, il nome descrittivo di un messaggio di traccia è il nome del file di origine e il numero di riga del codice che ha generato il messaggio di traccia.
%3	ULONG	ID thread. Identifica il thread che ha generato il messaggio di traccia.
%4	string	Timestamp dell'ora in cui è stato generato il messaggio di traccia.
%5	string	Ora del kernel. Visualizza il tempo di esecuzione trascorso per l'istruzione in modalità kernel, nei tick della CPU, al momento in cui è stato generato il messaggio di traccia.
%6	string	Tempo utente. Visualizza il tempo di esecuzione trascorso per l'istruzione in modalità utente, nei tick della CPU, al momento in cui è stato generato il messaggio di traccia.
%7	LONG	Numero di sequenza. Visualizza il numero di sequenza locale o globale del messaggio di traccia. I numeri di sequenza locali, univoci solo per questa sessione di traccia, sono i valori predefiniti.
%8	ULONG	ID processo. Identifica il processo che ha generato il messaggio di traccia.
%9	ULONG	Numero CPU. Identifica la CPU in cui è stato generato il messaggio di traccia.
%! FUNC!	string	Nome funzione. Visualizza il nome della funzione che ha generato il messaggio di traccia.
%! BANDIERE!	string	Visualizza il nome dei flag di traccia che abilitano il messaggio di traccia. Poiché la macro DoTraceMessage inverte i flag e gli argomenti di livello, i messaggi generati da DoTraceMessage visualizzano il valore del livello di traccia in questo campo.
%! LIVELLO!	string	Visualizza il valore del livello di traccia che abilita il messaggio di traccia. Poiché la macro DoTraceMessage inverte i flag e gli argomenti di livello, i messaggi generati da DoTraceMessage visualizzano il nome dei flag di traccia in questo campo.
%! COMPNAME!	string	Nome del componente, Visualizza il nome del componente del provider che ha generato il messaggio di traccia. Il nome del componente viene visualizzato solo se è specificato nel codice di traccia.
%! SOTTOCOMP!	string	Nome del sottocomponente. Visualizza il nome del sottocomponente del provider che ha generato il messaggio di traccia. Il nome del componente viene visualizzato solo se è specificato nel codice di traccia.

Il simbolo all'interno di punti esclamativi è un carattere di conversione che specifica la formattazione e la precisione della variabile. Ad esempio, %8!04X! specifica l'ID processo rappresentato come numero esadecimale senza segno a quattro cifre. Questi caratteri di conversione devono essere inclusi.

Per modificare gli elementi, l'ordine o la formattazione del prefisso del messaggio di traccia, utilizzare la variabile di ambiente %TRACE_FORMAT_PREFIX%. Per un esempio, vedere Esempio 7: Personalizzazione del prefisso del messaggio di traccia.

Per un esempio di contenuto in un file TMF, vedere Formattazione dei messaggi di traccia dall'esempio tracedrv.

Inoltre, il parametro -csv aggiunge un prefisso dettagliato non configurabile a ogni messaggio di traccia prima del prefisso Tracefmt standard. Per una descrizione dei campi nel prefisso CSV, usare il parametro -csvheader .