structure WNODE_SINGLE_INSTANCE (wmistr.h)

  • Article

La structure WNODE_SINGLE_INSTANCE contient des valeurs pour tous les éléments de données d’un instance d’un bloc de données.

Syntaxe

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;

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 de ce instance, 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 d’un instance inscrit avec des noms instance statiques. Ce membre est valide uniquement 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.

DataBlockOffset

Indique le décalage entre le début de cette structure et le début de la instance.

SizeDataBlock

Indique la taille du bloc de données pour cette instance.

VariableData

Contient des données supplémentaires, y compris le nom du instance dynamique, le cas échéant, le remplissage de sorte que la instance commence sur une limite de 8 octets et la instance du bloc de données à retourner.

Remarques

WMI transmet une WNODE_SINGLE_INSTANCE avec une demande IRP_MN_CHANGE_SINGLE_INSTANCE pour définir des éléments de données en lecture/écriture dans un instance d’un bloc de données. Un pilote peut ignorer les valeurs passées pour les éléments de données en lecture seule dans le instance.

Un pilote remplit une WNODE_SINGLE_INSTANCE en réponse à une demande de IRP_MN_QUERY_SINGLE_INSTANCE ou pour générer un événement qui se compose d’un seul instance.

Configuration requise

Condition requise Valeur
En-tête wmistr.h (inclure Wmistr.h)

Voir aussi

WNODE_EVENT_ITEM

WNODE_HEADER