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 .