WNODE_EVENT_ITEM Struktur (wmistr.h)
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;
Angehörige
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- übergebenen oder zurückgegebenen Daten bereitstellen.
Bemerkungen
Dem WnodeHeader Mitglied der WNODE_EVENT_ITEM-Struktur folgt eine Struktur, deren Typ von den Flags abhängt, die in WnodeHeader-festgelegt sind. Zu den Möglichkeiten gehören WNODE_ALL_DATA, WNODE_SINGLE_INSTANCEund WNODE_SINGLE_ITEM. Weitere Informationen zu den Flags finden Sie unter WNODE_HEADER.
Die ProviderId Member der WNODE_HEADER-Struktur für die Verwendung in einer WNODE_EVENT_ITEM-Struktur sollte mithilfe IoWMIDeviceObjectToProviderIdinitialisiert werden.
Ein Treiber generiert nur Ereignisse, die er zuvor als Reaktion auf eine IRP_MN_ENABLE_EVENTS-Anforderung aktiviert hat. Zum Generieren eines Ereignisses ruft ein Treiber IoWMIWriteEvent auf und übergibt einen Zeiger an die WNODE_EVENT_ITEM. WMI stellt das Ereignis für die Übermittlung an alle Datenkonsumenten 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_ITEMverwendet. Weitere Informationen zum Definieren und Generieren von WMI-Ereignissen finden Sie unter Windows-Verwaltungsinstrumentation.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | wmistr.h (include Wmistr.h) |