structure EVENT_DESCRIPTOR (relogger.h)

Article
08/25/2023

La structure EVENT_DESCRIPTOR contient des métadonnées qui définissent l’événement.

Syntaxe

typedef struct _EVENT_DESCRIPTOR {
  USHORT    Id;
  UCHAR     Version;
  UCHAR     Channel;
  UCHAR     Level;
  UCHAR     Opcode;
  USHORT    Task;
  ULONGLONG Keyword;
} EVENT_DESCRIPTOR, *PEVENT_DESCRIPTOR;

Membres

Id

Identificateur de l'événement.

Version

Version de l'événement. La version indique une révision de la définition de l’événement. Vous pouvez utiliser ce membre et le membre ID pour identifier de manière unique l’événement dans l’étendue d’un fournisseur.

Channel

Audience de l’événement (par exemple, administrateur ou développeur).

Level

Gravité ou niveau de détail inclus dans l’événement (par exemple, informationnel ou fatal).

Opcode

Étape d’une séquence d’opérations effectuées dans la tâche.

Task

Une unité de travail plus grande au sein d’une application ou d’un composant (est plus large que l’Opcode).

Keyword

Masque de bits qui spécifie un groupe logique d’événements associés. Chaque bit correspond à un groupe. Un événement peut appartenir à un ou plusieurs groupes. Le mot clé peut contenir un ou plusieurs mots clés définis par le fournisseur, des mots clés standard ou les deux.

Remarques

Cette structure représente un événement défini dans le manifeste. Vous ne déclarez pas et ne remplissez pas cette structure, mais vous utilisez le compilateur de messages (MC.exe) pour générer un fichier d’en-tête qui déclare et remplit cette structure pour chaque événement du manifeste. Pour plus d’informations sur l’écriture du manifeste et la génération du fichier d’en-tête, consultez Écriture d’un manifeste d’instrumentation et Compilation d’un manifeste d’instrumentation.

Pour plus d’informations sur les membres de cette structure, consultez les attributs du type complexe EventDefinitionType .

Vous spécifiez cette structure lorsque vous appelez EventWrite ou EventWriteTransfer pour écrire l’événement. Vous pouvez également l’utiliser lors de l’appel d’EventEnabled pour déterminer si vous devez écrire l’événement.

Cette structure est également incluse dans la structure EVENT_HEADER qui est retournée avec l’enregistrement d’événement lorsque vous consommez des événements à l’aide du rappel EventRecordCallback . Pour les événements définis par MOF, le membre Opcode contient la valeur du type d’événement. Les membres Version et Level contiennent les informations attendues.

Configuration requise

Condition requise	Valeur
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	relogger.h (inclure Evntprov.h)