WNODE_SINGLE_ITEM Struktur (wmistr.h)
Die WNODE_SINGLE_ITEM-Struktur enthält den Wert eines einzelnen Datenelements in einer Instanz eines Datenblocks.
Syntax
typedef struct tagWNODE_SINGLE_ITEM {
struct _WNODE_HEADER WnodeHeader;
ULONG OffsetInstanceName;
ULONG InstanceIndex;
ULONG ItemId;
ULONG DataBlockOffset;
ULONG SizeDataItem;
UCHAR VariableData[];
} WNODE_SINGLE_ITEM, *PWNODE_SINGLE_ITEM;
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 GUID, die einem Anforderung zugeordneten Datenblock darstellt, und Flags, die Informationen zu den WNODE_XXX- übergebenen oder zurückgegebenen Daten bereitstellen.
OffsetInstanceName
Gibt den Offset vom Anfang dieser Struktur bis zum Namen der dynamischen Instanz an, falls vorhanden, an einer USHORT-Grenze ausgerichtet. Dieses Element ist nur gültig, wenn WNODE_FLAG_STATIC_INSTANCE_NAMES in WnodeHeader.Flagsklar ist. Wenn der Datenblock mit namen statischer Instanz registriert wurde, ignoriert WMI OffsetInstanceName.
InstanceIndex
Gibt den Index in der Liste der statischen Instanznamen dieser Instanz an. Dieses Element ist nur gültig, wenn der Datenblock mit namen statischer Instanz registriert wurde und WNODE_FLAG_STATIC_INSTANCE_NAMES in WnodeHeader.Flagsfestgelegt ist. Wenn der Datenblock mit namen der dynamischen Instanz registriert wurde, ignoriert WMI InstanceIndex-.
ItemId
Gibt die ID des festzulegenden Datenelements an.
DataBlockOffset
Gibt den Offset vom Anfang dieser Struktur bis zum neuen Wert für das Datenelement an.
SizeDataItem
Gibt die Größe des Datenelements an.
VariableData
Enthält zusätzliche Daten, einschließlich des namens der dynamischen Instanz, falls vorhanden, der Abstand, sodass der Datenwert auf einer Grenze von 8 Byte beginnt, und den neuen Wert für das Datenelement.
Bemerkungen
WMI übergibt eine WNODE_SINGLE_ITEM mit einer IRP_MN_CHANGE_SINGLE_ITEM Anforderung, den Wert eines Datenelements in einer Instanz eines Datenblocks festzulegen.
Ein Treiber erstellt eine WNODE_SINGLE_ITEM, um ein Ereignis zu generieren, das aus einem einzelnen Datenelement besteht.
Anforderungen
Anforderung | Wert |
---|---|
Header- | wmistr.h (include Wmistr.h) |