structure EVENT_TRACE (evntrace.h)

  • Article

La structure EVENT_TRACE est utilisée pour fournir des informations sur les événements à un consommateur de trace d’événements.

Syntaxe

typedef struct _EVENT_TRACE {
  EVENT_TRACE_HEADER Header;
  ULONG              InstanceId;
  ULONG              ParentInstanceId;
  GUID               ParentGuid;
  PVOID              MofData;
  ULONG              MofLength;
  union {
    ULONG              ClientContext;
    ETW_BUFFER_CONTEXT BufferContext;
  } DUMMYUNIONNAME;
} EVENT_TRACE, *PEVENT_TRACE;

Membres

Header

Structure EVENT_TRACE_HEADER qui contient des informations de suivi d’événements standard.

InstanceId

Identificateur d’instance. Contient des données valides lorsque le fournisseur appelle la fonction TraceEventInstance pour générer l’événement. Sinon, la valeur est égale à zéro.

ParentInstanceId

Identificateur d’instance d’un événement parent. Contient des données valides lorsque le fournisseur appelle la fonction TraceEventInstance pour générer l’événement. Sinon, la valeur est égale à zéro.

ParentGuid

GUID de classe de l’événement parent. Contient des données valides lorsque le fournisseur appelle la fonction TraceEventInstance pour générer l’événement. Sinon, la valeur est égale à zéro.

MofData

Pointeur vers le début des données spécifiques à l’événement pour cet événement.

MofLength

Nombre d’octets vers lesquels MofData pointe.

DUMMYUNIONNAME

DUMMYUNIONNAME.ClientContext

Réservé.

DUMMYUNIONNAME.BufferContext

Fournit des informations sur l’événement, telles que l’identificateur de session et le numéro de processeur du processeur sur lequel le processus du fournisseur s’est exécuté. Pour plus d’informations, consultez la structure ETW_BUFFER_CONTEXT .

Avant Windows Vista : Non pris en charge.

Remarques

ProcessTrace transmet cette structure à la fonction de rappel EventCallback du consommateur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête evntrace.h

Voir aussi

EventCallback