WNODE_SINGLE_ITEM structure (wmistr.h)
La structure WNODE_SINGLE_ITEM contient la valeur d’un élément de données unique dans un instance d’un bloc de données.
Syntaxe
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;
Membres
WnodeHeader
Structure WNODE_HEADER qui contient des informations communes à toutes les structures WNODE_XXX , telles que la taille de la mémoire tampon, le GUID qui représente un bloc de données associé à une demande et les indicateurs qui fournissent des informations sur les données WNODE_XXX passées ou retournées.
OffsetInstanceName
Indique le décalage entre le début de cette structure et le nom de instance dynamique, le cas échéant, aligné sur une limite USHORT. Ce membre est valide uniquement si WNODE_FLAG_STATIC_INSTANCE_NAMES est clair dans WnodeHeader.Flags. Si le bloc de données a été inscrit avec des noms instance statiques, WMI ignore OffsetInstanceName.
InstanceIndex
Indique l’index dans la liste des noms de instance statiques de ce instance du pilote. Ce membre est valide uniquement si le bloc de données a été inscrit avec des noms de instance statiques et si WNODE_FLAG_STATIC_INSTANCE_NAMES est défini dans WnodeHeader.Flags. Si le bloc de données a été inscrit avec des noms de instance dynamiques, WMI ignore InstanceIndex.
ItemId
Spécifie l’ID de l’élément de données à définir.
DataBlockOffset
Indique le décalage entre le début de cette structure et la nouvelle valeur de l’élément de données.
SizeDataItem
Indique la taille de l’élément de données.
VariableData
Contient des données supplémentaires, y compris le nom de instance dynamique le cas échéant, un remplissage de sorte que la valeur de données commence sur une limite de 8 octets et la nouvelle valeur de l’élément de données.
Remarques
WMI transmet une WNODE_SINGLE_ITEM avec une demande IRP_MN_CHANGE_SINGLE_ITEM pour définir la valeur d’un élément de données dans une instance d’un bloc de données.
Un pilote génère un WNODE_SINGLE_ITEM pour générer un événement qui se compose d’un seul élément de données.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | wmistr.h (inclure Wmistr.h) |