EVENT_DESCRIPTOR-Struktur (relogger.h)
Die EVENT_DESCRIPTOR-Struktur enthält Metadaten, die das Ereignis definieren.
Syntax
typedef struct _EVENT_DESCRIPTOR {
USHORT Id;
UCHAR Version;
UCHAR Channel;
UCHAR Level;
UCHAR Opcode;
USHORT Task;
ULONGLONG Keyword;
} EVENT_DESCRIPTOR, *PEVENT_DESCRIPTOR;
Member
Id
Der Ereignisbezeichner.
Version
Die Version des Ereignisses. Die Version gibt eine Überarbeitung der Ereignisdefinition an. Sie können dieses Element und das Id-Element verwenden, um das Ereignis innerhalb des Bereichs eines Anbieters eindeutig zu identifizieren.
Channel
Die Zielgruppe für das Ereignis (z. B. Administrator oder Entwickler).
Level
Der Schweregrad oder die Detailebene, die im Ereignis enthalten ist (z. B. informationell oder schwerwiegend).
Opcode
Ein Schritt in einer Abfolge von Vorgängen, die innerhalb der Aufgabe ausgeführt werden.
Task
Eine größere Arbeitseinheit innerhalb einer Anwendung oder Komponente (ist breiter als der Opcode).
Keyword
Eine Bitmaske, die eine logische Gruppe verwandter Ereignisse angibt. Jedes Bit entspricht einer Gruppe. Ein Ereignis kann zu einer oder mehreren Gruppen gehören. Das Schlüsselwort kann mindestens ein vom Anbieter definiertes Schlüsselwort, Standardschlüsselwort oder beides enthalten.
Hinweise
Diese Struktur stellt ein im Manifest definiertes Ereignis dar. Sie deklarieren und füllen diese Struktur nicht, sondern verwenden den Nachrichtencompiler (MC.exe), um eine Headerdatei zu generieren, die diese Struktur für jedes Ereignis im Manifest deklariert und auffüllt. Ausführliche Informationen zum Schreiben des Manifests und zum Generieren der Headerdatei finden Sie unter Schreiben eines Instrumentierungsmanifests und Kompilieren eines Instrumentierungsmanifests.
Ausführliche Informationen zu den Membern dieser Struktur finden Sie unter den Attributen des komplexen Typs EventDefinitionType .
Sie geben diese Struktur an, wenn Sie EventWrite oder EventWriteTransfer aufrufen, um das Ereignis zu schreiben. Sie können es auch beim Aufrufen von EventEnabled verwenden, um zu bestimmen, ob Sie das Ereignis schreiben sollten.
Diese Struktur ist auch in der EVENT_HEADER-Struktur enthalten, die mit dem Ereignisdatensatz zurückgegeben wird, wenn Sie Ereignisse mithilfe des EventRecordCallback-Rückrufs nutzen. Für MOF-definierte Ereignisse enthält das Opcode-Element den Ereignistypwert. Die Elemente Version und Level enthalten die erwarteten Informationen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Kopfzeile | relogger.h (evntprov.h einschließen) |