EVENT_HEADER_EXTENDED_DATA_ITEM structure (evntcons.h)

  • Article

Définit les données étendues que le suivi d’événements pour Windows (ETW) collecte 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. Voici les valeurs possibles.

Valeur Signification
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_TS_ID
 Le membre DataPtr pointe vers une structure de 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 EnablePropertyd’EnableTraceEx sur EVENT_ENABLE_PROPERTY_TS_ID.
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO
 Le membre DataPtr pointe vers une structure de EVENT_EXTENDED_ITEM_INSTANCE qui contient l’identificateur d’activité si vous avez appelé TraceEventInstance pour écrire l’événement.
EVENT_HEADER_EXT_TYPE_STACK_TRACE32
 Le membre DataPtr 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 membre DataPtr 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_EVENT_SCHEMA_TL
 Le membre DataPtr 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_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_EVENT_KEY
 Le membre DataPtr 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 passé pour l’appel EnableTrace pour un fournisseur donné afin d’activer cette fonctionnalité.
EVENT_HEADER_EXT_TYPE_PROCESS_START_KEY
 Le membre DataPtr 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 passé pour l’appel EnableTrace pour un fournisseur donné afin d’activer cette fonctionnalité.

Linkage

Réservé.

Reserved2

Réservé.

DataSize

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

DataPtr

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

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête evntcons.h (inclure Evntcons.h)

Voir aussi

EVENT_RECORD