WNODE_EVENT_ITEM-Struktur (wmistr.h)

Artikel
03/01/2024

Die WNODE_EVENT_ITEM-Struktur enthält Daten, die von einem Treiber für ein Ereignis generiert werden.

Syntax

typedef struct tagWNODE_EVENT_ITEM {
  struct _WNODE_HEADER WnodeHeader;
} WNODE_EVENT_ITEM, *PWNODE_EVENT_ITEM;

Member

WnodeHeader

Gibt eine WNODE_HEADER-Struktur an, die Informationen enthält, die allen WNODE_XXX-Strukturen gemeinsam sind, z. B. die Puffergröße, die GUID, die einen datenblock darstellt, der einer Anforderung zugeordnet ist, und Flags, die Informationen zu den WNODE_XXX-Daten bereitstellen, die übergeben oder zurückgegeben werden.

Hinweise

Auf das WnodeHeader-Element der WNODE_EVENT_ITEM-Struktur folgt eine Struktur, deren Typ von den in WnodeHeader festgelegten Flags abhängt. Möglichkeiten sind WNODE_ALL_DATA, WNODE_SINGLE_INSTANCE und WNODE_SINGLE_ITEM. Weitere Informationen zu den Flags finden Sie unter WNODE_HEADER.

Das ProviderId-Element der WNODE_HEADER-Struktur zur Verwendung in einer WNODE_EVENT_ITEM-Struktur sollte mit IoWMIDeviceObjectToProviderId initialisiert werden.

Ein Treiber generiert nur Ereignisse, die er zuvor als Reaktion auf eine IRP_MN_ENABLE_EVENTS-Anforderung aktiviert hat. Um ein Ereignis zu generieren, ruft ein Treiber IoWMIWriteEvent auf und übergibt einen Zeiger auf den WNODE_EVENT_ITEM. WMI stellt das Ereignis für die Übermittlung an alle Datenconsumer in die Warteschlange, die für dieses Ereignis registriert sind.

Um eine optimale Leistung zu erzielen, sollten Ereignisse klein sein. Wenn die Datenmenge für ein Ereignis jedoch die in der Registrierung definierte maximale Größe überschreitet, kann ein Treiber eine WNODE_EVENT_REFERENCE übergeben, die WMI zum Abfragen der zugehörigen WNODE_EVENT_ITEM verwendet. Weitere Informationen zum Definieren und Generieren von WMI-Ereignissen finden Sie unter Windows-Verwaltungsinstrumentation.