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)

Weitere Informationen

EVENT_HEADER

EventDescCreate

EventDescGetChannel

EventDescGetId

EventDescGetKeyword

EventDescGetLevel

EventDescGetOpcode

EventDescGetTask

EventDescGetVersion

EventDescOrKeyword

EventDescSetChannel

EventDescSetId

EventDescSetKeyword

EventDescSetLevel

EventDescSetOpcode

EventDescSetTask

EventDescSetVersion

EventDescZero

EventEnabled

EventWrite

EventWriteTransfer

PROVIDER_EVENT_INFO

TdhEnumerateManifestProviderEvents

TdhGetManifestEventInformation