Condividi tramite

struttura EVENT_HEADER_EXTENDED_DATA_ITEM (evntcons.h)

  • Articolo

Definisce i dati estesi raccolti da Event Tracing for Windows (ETW) come parte dei dati dell'evento.

Sintassi

typedef struct _EVENT_HEADER_EXTENDED_DATA_ITEM {
  USHORT    Reserved1;
  USHORT    ExtType;
  struct {
    USHORT Linkage : 1;
    USHORT Reserved2 : 15;
  };
  USHORT    DataSize;
  ULONGLONG DataPtr;
} EVENT_HEADER_EXTENDED_DATA_ITEM, *PEVENT_HEADER_EXTENDED_DATA_ITEM;

Membri

Reserved1

Riservato.

ExtType

Tipo di dati estesi. Gli esempi seguenti sono alcuni valori possibili.

Valore Significato
EVENT_HEADER_EXT_TYPE_EVENT_KEY
 Il DataPtr membro punta a una struttura EVENT_EXTENDED_ITEM_EVENT_KEY contenente un identificatore di evento univoco che è scalare a 64 bit.

Il EVENT_ENABLE_PROPERTY_EVENT_KEY EnableProperty deve essere passato per la chiamata EnableTrace per consentire a un determinato provider di abilitare questa funzionalità.
EVENT_HEADER_EXT_TYPE_EVENT_SCHEMA_TL
 Il DataPtr fa riferimento a un elemento di intestazione estesa che contiene informazioni sui metadati dell'evento TraceLogging.
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO
 Il membro DataPtr punta a una struttura EVENT_EXTENDED_ITEM_INSTANCE che contiene l'identificatore dell'attività se è stato chiamato TraceEventInstance per scrivere l'evento.
EVENT_HEADER_EXT_TYPE_PMC_COUNTERS
 Il membro DataPtr punta a una struttura EVENT_EXTENDED_ITEM_PMC_COUNTERS che contiene i valori correnti del contatore PMC. Per abilitare questa funzionalità, i contatori PMC validi per la CPU devono essere impostati tramite TraceSetInformation, con valori di origine validi trovati chiamando TraceQueryInformation con TraceProfileSourceListInfo.
EVENT_HEADER_EXT_TYPE_PROCESS_START_KEY
 Il DataPtr membro punta a una struttura EVENT_EXTENDED_ITEM_PROCESS_START_KEY che contiene un identificatore di processo univoco (univoco nella sessione di avvio). Questo identificatore è un scalare a 64 bit.

Il EVENT_ENABLE_PROPERTY_PROCESS_START_KEY EnableProperty deve essere passato per la chiamata EnableTrace per consentire a un determinato provider di abilitare questa funzionalità.
EVENT_HEADER_EXT_TYPE_PROV_TRAITS
 Il DataPtr membro punta a un elemento di intestazione esteso che contiene i dati dei tratti del provider, ad esempio tratti impostati tramite EventSetInformation(EventProviderSetTraits) o specificati tramite EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA.
EVENT_HEADER_EXT_TYPE_RELATED_ACTIVITYID
 Il DataPtr membro punta a una struttura EVENT_EXTENDED_ITEM_RELATED_ACTIVITYID che contiene l'identificatore di attività correlato se è stato chiamato EventWriteTransfer per scrivere l'evento.
EVENT_HEADER_EXT_TYPE_SID
 Il DataPtr membro punta a una struttura SID che contiene l'identificatore di sicurezza (SID) dell'utente che ha registrato l'evento. ETW include il SID se si imposta il parametro EnableProperty di EnableTraceEx su EVENT_ENABLE_PROPERTY_SID.
EVENT_HEADER_EXT_TYPE_STACK_TRACE32
 Il DataPtr membro punta a una struttura EVENT_EXTENDED_ITEM_STACK_TRACE32 che contiene lo stack di chiamate se l'evento viene acquisito in un computer a 32 bit.
EVENT_HEADER_EXT_TYPE_STACK_TRACE64
 Il DataPtr membro punta a una struttura EVENT_EXTENDED_ITEM_STACK_TRACE64 che contiene lo stack di chiamate se l'evento viene acquisito in un computer a 64 bit.
EVENT_HEADER_EXT_TYPE_TS_ID
 Il DataPtr membro punta a una struttura EVENT_EXTENDED_ITEM_TS_ID che contiene l'identificatore di sessione del terminale. ETW include l'identificatore di sessione del terminale se si imposta il parametro EnableProperty di EnableTraceEx su EVENT_ENABLE_PROPERTY_TS_ID.

Linkage

Riservato.

Reserved2

Riservato.

DataSize

Dimensioni, in byte, dei dati estesi a cui DataPtr punta.

DataPtr

Puntatore ai dati estesi. Il membro extType determina il tipo di dati estesi a cui punta questo membro.

Fabbisogno

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)

Vedere anche

EVENT_RECORD