WNODE_SINGLE_ITEM structure (wmistr.h)

  • Article

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)

Voir aussi

WNODE_EVENT_ITEM

WNODE_HEADER