WNODE_EVENT_REFERENCE-Struktur (wmistr.h)
Die WNODE_EVENT_REFERENCE-Struktur enthält Informationen, die WMI verwenden kann, um ein Ereignis abzufragen, das den in der Registrierung festgelegten Grenzwert für die Ereignisgröße überschreitet.
Syntax
typedef struct tagWNODE_EVENT_REFERENCE {
struct _WNODE_HEADER WnodeHeader;
GUID TargetGuid;
ULONG TargetDataBlockSize;
union {
ULONG TargetInstanceIndex;
WCHAR TargetInstanceName[];
} DUMMYUNIONNAME;
} WNODE_EVENT_REFERENCE, *PWNODE_EVENT_REFERENCE;
Member
WnodeHeader
Ist eine WNODE_HEADER-Struktur , die informationen enthält, die allen WNODE_XXX-Strukturen gemeinsam sind, z. B. die Puffergröße, die Anbieter-ID, die GUID, die einen Datenblock darstellt, der einer Anforderung zugeordnet ist, und Flags, die Informationen über die WNODE_XXX-Daten bereitstellen, die übergeben oder zurückgegeben werden.
TargetGuid
Gibt die GUID an, die das abzufragende Ereignis darstellt.
TargetDataBlockSize
Gibt die Größe des Ereignisses an.
DUMMYUNIONNAME
DUMMYUNIONNAME.TargetInstanceIndex
Gibt den Index in der Liste der statischen instance Namen des Treibers für das Ereignis an. Dieser Member ist nur gültig, wenn der Ereignisblock mit statischen instance Namen registriert wurde und WNODE_FLAGS_STATIC_INSTANCE_NAMES in WnodeHeader.Flags festgelegt ist.
DUMMYUNIONNAME.TargetInstanceName
Gibt den dynamischen instance Namen des Ereignisses als gezählte Unicode-Zeichenfolge an. Dieser Member ist nur gültig, wenn WNODE_FLAGS_STATIC_INSTANCE_NAMES in WnodeHeader.Flags eindeutig ist und der Ereignisblock mit dynamischen instance Namen registriert wurde.
Hinweise
Wenn die Datenmenge für ein Ereignis die in der Registrierung festgelegte maximale Größe überschreitet, kann ein Treiber einen WNODE_EVENT_REFERENCE generieren, der eine WNODE_EVENT_ITEM angibt, die WMI abfragen kann, um das Ereignis abzurufen. Weitere Informationen zum Definieren und Generieren von WMI-Ereignissen finden Sie unter Implementieren von WMI.
Das ProviderId-Element der WNODE_HEADER-Struktur zur Verwendung in einer WNODE_EVENT_REFERENCE-Struktur sollte mithilfe von IoWMIDeviceObjectToProviderId initialisiert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | wmistr.h (einschließlich Wmistr.h) |