WNODE_EVENT_REFERENCE-Struktur (wmistr.h)

  • Artikel

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)

Weitere Informationen

IoWMIDeviceObjectToProviderId

WNODE_EVENT_ITEM

WNODE_HEADER