WNODE_SINGLE_INSTANCE-Struktur (wmistr.h)

  • Artikel

Die WNODE_SINGLE_INSTANCE-Struktur enthält Werte für alle Datenelemente in einer instance eines Datenblocks.

Syntax

typedef struct tagWNODE_SINGLE_INSTANCE {
  struct _WNODE_HEADER WnodeHeader;
  ULONG                OffsetInstanceName;
  ULONG                InstanceIndex;
  ULONG                DataBlockOffset;
  ULONG                SizeDataBlock;
  UCHAR                VariableData[];
} WNODE_SINGLE_INSTANCE, *PWNODE_SINGLE_INSTANCE;

Member

WnodeHeader

Ist eine WNODE_HEADER-Struktur , 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 über die WNODE_XXX-Daten bereitstellen, die übergeben oder zurückgegeben werden.

OffsetInstanceName

Gibt den Offset vom Anfang dieser Struktur bis zum dynamischen instance Namen dieses instance an, der an einer USHORT-Grenze ausgerichtet ist. Dieser Member ist nur gültig, wenn WNODE_FLAG_STATIC_INSTANCE_NAMES in WnodeHeader.Flags eindeutig ist. Wenn der Datenblock mit statischen instance Namen registriert wurde, ignoriert WMI OffsetInstanceName.

InstanceIndex

Gibt den Index eines mit statischen instance Namen registrierten instance an. Dieser Member ist nur gültig, wenn WNODE_FLAG_STATIC_INSTANCE_NAMES in WnodeHeader.Flags festgelegt ist. Wenn der Datenblock mit dynamischen instance Namen registriert wurde, ignoriert WMI InstanceIndex.

DataBlockOffset

Gibt den Offset vom Anfang dieser Struktur bis zum Anfang der instance an.

SizeDataBlock

Gibt die Größe des Datenblocks für diesen instance an.

VariableData

Enthält zusätzliche Daten, einschließlich des dynamischen instance Namens(falls vorhanden), des Auffüllens, damit die instance an einer 8-Byte-Grenze beginnt, und die instance des zurückzugebenden Datenblocks.

Hinweise

WMI übergibt eine WNODE_SINGLE_INSTANCE mit einer IRP_MN_CHANGE_SINGLE_INSTANCE Anforderung zum Festlegen von Lese-/Schreibdatenelementen in einer instance eines Datenblocks. Ein Treiber kann Werte ignorieren, die für schreibgeschützte Datenelemente im instance übergeben wurden.

Ein Treiber füllt eine WNODE_SINGLE_INSTANCE aus, um auf eine IRP_MN_QUERY_SINGLE_INSTANCE Anforderung zu reagieren oder um ein Ereignis zu generieren, das aus einem einzelnen instance besteht.

Anforderungen

Anforderung Wert
Header wmistr.h (einschließlich Wmistr.h)

Weitere Informationen

WNODE_EVENT_ITEM

WNODE_HEADER