struttura EVENT_RECORD (evntcons.h)

Articolo
08/23/2023

Definisce il layout di un evento recapitato da Event Tracing for Windows (ETW).

Sintassi

typedef struct _EVENT_RECORD {
  EVENT_HEADER                     EventHeader;
  ETW_BUFFER_CONTEXT               BufferContext;
  USHORT                           ExtendedDataCount;
  USHORT                           UserDataLength;
  PEVENT_HEADER_EXTENDED_DATA_ITEM ExtendedData;
  PVOID                            UserData;
  PVOID                            UserContext;
} EVENT_RECORD, *PEVENT_RECORD;

Members

EventHeader

Informazioni sull'evento, ad esempio il timestamp per il momento in cui è stato scritto. Per informazioni dettagliate, vedere la struttura EVENT_HEADER .

BufferContext

Definisce informazioni quali la sessione che ha registrato l'evento. Per informazioni dettagliate, vedere la struttura ETW_BUFFER_CONTEXT .

ExtendedDataCount

Numero di strutture di dati estese nel membro ExtendedData .

UserDataLength

Dimensione, in byte, dei dati nel membro UserData .

ExtendedData

Uno o più elementi di dati estesi raccolti da ETW. I dati estesi includono alcuni elementi, ad esempio l'identificatore di sicurezza (SID) dell'utente che ha registrato l'evento, solo se il controller imposta il parametro EnableProperty passato alla funzione EnableTraceEx o EnableTraceEx2 . I dati estesi includono altri elementi, ad esempio l'identificatore di attività correlato e le informazioni di decodifica per la registrazione della traccia, indipendentemente dal fatto che il controller imposti il parametro EnableProperty passato a EnableTraceEx o EnableTraceEx2. Per informazioni dettagliate, vedere la struttura EVENT_HEADER_EXTENDED_DATA_ITEM .

UserData

Dati specifici dell'evento. Per analizzare questi dati, vedere Recupero dei dati degli eventi tramite TDH. Se il membro Flags di EVENT_HEADER contiene EVENT_HEADER_FLAG_STRING_ONLY, i dati sono una stringa Unicode con terminazione Null che non è necessario analizzare TDH.

UserContext

Contesto specificato nel membro Context della struttura EVENT_TRACE_LOGFILE passata alla funzione OpenTrace .

Commenti

La struttura EVENT_RECORD viene passata all'implementazione del consumer del callback EventRecordCallback .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	evntcons.h (include Evntcons.h)