enumerazione TDH_CONTEXT_TYPE (tdh.h)

Articolo
08/26/2023

Definisce il tipo di contesto.

Sintassi

typedef enum _TDH_CONTEXT_TYPE {
  TDH_CONTEXT_WPP_TMFFILE,
  TDH_CONTEXT_WPP_TMFSEARCHPATH,
  TDH_CONTEXT_WPP_GMT,
  TDH_CONTEXT_POINTERSIZE,
  TDH_CONTEXT_PDB_PATH,
  TDH_CONTEXT_MAXIMUM
} TDH_CONTEXT_TYPE;

Costanti


`TDH_CONTEXT_WPP_TMFFILE` Stringa Unicode con terminazione null contenente il nome del file con estensione tmf usato per l'analisi del log WPP. In genere, il nome del file tmf viene selezionato dal GUID dell'evento in modo da non dover specificare il nome del file.
`TDH_CONTEXT_WPP_TMFSEARCHPATH` Stringa Unicode con terminazione null contenente il percorso del file .tmf. Non è necessario specificare questo percorso se il percorso di ricerca contiene il file. Specificare solo queste informazioni di contesto se si specifica anche il tipo di contesto TDH_CONTEXT_WPP_TMFFILE. Se il file non viene trovato, TDH cerca i percorsi seguenti nell'ordine specificato: Percorso specificato nella variabile di ambiente TRACE_FORMAT_SEARCH_PATH Cartella corrente
`TDH_CONTEXT_WPP_GMT` Flag booleano a 1 byte che indica se il timestamp dell'evento WPP deve essere convertito in Coordinate temporali universali (UTC). Se 1, il timestamp viene convertito in UTC. Se 0, il timestamp è in ora locale. Per impostazione predefinita, il timestamp è in ora locale.
`TDH_CONTEXT_POINTERSIZE` Dimensioni, in byte, dei tipi di dati puntatore o size_t tipi di dati usati nell'evento. Indica se l'evento usato valori da 4 byte o da 8 byte. Per impostazione predefinita, le dimensioni del puntatore sono le dimensioni del puntatore del computer di decodifica. Per determinare le dimensioni del puntatore o size_t valore, usare il membro PointerSize di TRACE_LOGFILE_HEADER (il primo evento ricevuto nel callback EventRecordCallback contiene questa intestazione nella sezione dati). Tuttavia, questo valore potrebbe non essere accurato. Ad esempio, in un computer a 64 bit, un'applicazione a 32 bit registra puntatori a 4 byte; tuttavia, la sessione imposta PointerSize su 8.
`TDH_CONTEXT_PDB_PATH` Stringa Unicode con terminazione null contenente il nome del file pdb per il file binario contenente messaggi WPP. Questo parametro può essere usato come alternativa a TDH_CONTEXT_WPP_TMFFILE o TDH_CONTEXT_WPP_TMFSEARCHPATH. Nota Disponibile solo per Windows 8 e Windows Server 2012.
`TDH_CONTEXT_MAXIMUM` Riservato.

Commenti

Se si specificano informazioni di contesto per un evento ETW legacy, è necessario specificare solo il tipo di TDH_CONTEXT_POINTERSIZE, ovvero gli altri tipi vengono usati per gli eventi WPP e vengono ignorati per gli eventi ETW legacy.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	tdh.h

Vedi anche

TDH_CONTEXT

Condividi tramite