structure EVENT_DESCRIPTOR (relogger.h)
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) |