WNODE_SINGLE_INSTANCE-Struktur (wmistr.h)
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) |