structure EVENT_HEADER_EXTENDED_DATA_ITEM (evntcons.h)

Définit les données étendues collectées par le suivi des événements pour Windows (ETW) dans le cadre des données d’événement.

Syntaxe

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;

Membres

Reserved1

Réservé.

ExtType

Type de données étendues. Les exemples suivants sont des valeurs possibles.

Valeur	Signification
EVENT_HEADER_EXT_TYPE_EVENT_KEY	Le DataPtr membre pointe vers une structure EVENT_EXTENDED_ITEM_EVENT_KEY contenant un identificateur d’événement unique qui est un scalaire 64 bits. Le EVENT_ENABLE_PROPERTY_EVENT_KEY EnableProperty doit être transmis pour l’appel EnableTrace d’un fournisseur donné pour activer cette fonctionnalité.
EVENT_HEADER_EXT_TYPE_EVENT_SCHEMA_TL	Le DataPtr membre pointe vers un élément d’en-tête étendu qui contient des informations de métadonnées d’événement TraceLogging.
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO	Le membre DataPtr pointe vers une structure EVENT_EXTENDED_ITEM_INSTANCE qui contient l’identificateur d’activité si vous avez appelé TraceEventInstance pour écrire l’événement.
EVENT_HEADER_EXT_TYPE_PMC_COUNTERS	Le membre DataPtr pointe vers une structure EVENT_EXTENDED_ITEM_PMC_COUNTERS qui contient les valeurs actuelles du compteur PMC. Pour activer cette fonctionnalité, les compteurs PMC valides pour l’UC doivent être définis via traceSetInformation, avec des valeurs source valides trouvées en appelant TraceQueryInformation avec TraceProfileSourceListInfo.
EVENT_HEADER_EXT_TYPE_PROCESS_START_KEY	Le DataPtr membre pointe vers une structure EVENT_EXTENDED_ITEM_PROCESS_START_KEY qui contient un identificateur de processus unique (unique dans la session de démarrage). Cet identificateur est un scalaire 64 bits. Le EVENT_ENABLE_PROPERTY_PROCESS_START_KEY EnableProperty doit être transmis pour l’appel EnableTrace pour qu’un fournisseur donné puisse activer cette fonctionnalité.
EVENT_HEADER_EXT_TYPE_PROV_TRAITS	Le membre DataPtr pointe vers un élément d’en-tête étendu qui contient des données de caractéristiques de fournisseur, par exemple des caractéristiques définies via EventSetInformation(EventProviderSetTraits) ou spécifiées via EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA.
EVENT_HEADER_EXT_TYPE_RELATED_ACTIVITYID	Le membre DataPtr pointe vers une structure EVENT_EXTENDED_ITEM_RELATED_ACTIVITYID qui contient l’identificateur d’activité associé si vous avez appelé EventWriteTransfer pour écrire l’événement.
EVENT_HEADER_EXT_TYPE_SID	Le membre DataPtr pointe vers une structure SID qui contient l’identificateur de sécurité (SID) de l’utilisateur qui a enregistré l’événement. ETW inclut le SID si vous définissez le paramètre EnableProperty de EnableTraceEx sur EVENT_ENABLE_PROPERTY_SID.
EVENT_HEADER_EXT_TYPE_STACK_TRACE32	Le DataPtr membre pointe vers une structure EVENT_EXTENDED_ITEM_STACK_TRACE32 qui contient la pile des appels si l’événement est capturé sur un ordinateur 32 bits.
EVENT_HEADER_EXT_TYPE_STACK_TRACE64	Le DataPtr membre pointe vers une structure EVENT_EXTENDED_ITEM_STACK_TRACE64 qui contient la pile des appels si l’événement est capturé sur un ordinateur 64 bits.
EVENT_HEADER_EXT_TYPE_TS_ID	Le membre DataPtr pointe vers une structure EVENT_EXTENDED_ITEM_TS_ID qui contient l’identificateur de session de terminal. ETW inclut l’identificateur de session de terminal si vous définissez le paramètre EnableProperty de EnableTraceEx sur EVENT_ENABLE_PROPERTY_TS_ID.

Linkage

Réservé.

Reserved2

Réservé.

DataSize

Taille, en octets, des données étendues qui DataPtr pointe vers.

DataPtr

Pointeur vers les données étendues. Le membre ExtType détermine le type de données étendues auxquelles ce membre pointe.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
d’en-tête	evntcons.h (include Evntcons.h)

Voir aussi

EVENT_RECORD