WNODE_EVENT_REFERENCE Struktur (wmistr.h)

Die WNODE_EVENT_REFERENCE Struktur enthält Informationen, die WMI zum Abfragen eines Ereignisses verwenden kann, 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;

Angehörige

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 einem Anforderung zugeordneten Datenblock darstellt, und Flags, die Informationen zu den WNODE_XXX- übergebenen oder zurückgegebenen Daten bereitstellen.

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 Instanznamen für das Ereignis an. Dieses Element ist nur gültig, wenn der Ereignisblock mit namen statischer Instanz registriert wurde und WNODE_FLAGS_STATIC_INSTANCE_NAMES in WnodeHeader.Flagsfestgelegt wird.

DUMMYUNIONNAME.TargetInstanceName

Gibt den Namen der dynamischen Instanz des Ereignisses als gezählte Unicode-Zeichenfolge an. Dieses Element ist nur gültig, wenn WNODE_FLAGS_STATIC_INSTANCE_NAMES in WnodeHeader.Flags klar ist und der Ereignisblock mit dynamischen Instanznamen registriert wurde.

Bemerkungen

Wenn die Datenmenge für ein Ereignis die in der Registrierung festgelegte maximale Größe überschreitet, kann ein Treiber eine WNODE_EVENT_REFERENCE generieren, die 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- Mitglied der WNODE_HEADER Struktur für die Verwendung in einer WNODE_EVENT_REFERENCE-Struktur sollte mithilfe IoWMIDeviceObjectToProviderIdinitialisiert werden.

Anforderungen

Siehe auch

IoWMIDeviceObjectToProviderId

WNODE_EVENT_ITEM

WNODE_HEADER