structure WNODE_SINGLE_INSTANCE (wmistr.h)
La structure WNODE_SINGLE_INSTANCE contient des valeurs pour tous les éléments de données d’une 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 des indicateurs qui fournissent des informations sur les WNODE_XXX données transmises ou retournées.
OffsetInstanceName
Indique le décalage entre le début de cette structure et le nom de l’instance dynamique de cette 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 d’instances statiques, WMI ignore OffsetInstanceName.
InstanceIndex
Indique l’index d’une instance inscrite avec des noms d’instances statiques. Ce membre n’est valide que si WNODE_FLAG_STATIC_INSTANCE_NAMES est défini dans WnodeHeader.Flags. Si le bloc de données a été inscrit avec des noms d’instances dynamiques, WMI ignore InstanceIndex.
DataBlockOffset
Indique le décalage entre le début de cette structure et le début de l’instance.
SizeDataBlock
Indique la taille du bloc de données pour cette instance.
VariableData
Contient des données supplémentaires, y compris le nom de l’instance dynamique le cas échéant, le remplissage afin que l’instance commence sur une limite de 8 octets et l’instance du bloc de données à retourner.
Remarques
WMI transmet une WNODE_SINGLE_INSTANCE avec une demande de IRP_MN_CHANGE_SINGLE_INSTANCE pour définir des éléments de données en lecture/écriture dans une 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 l’instance.
Un pilote remplit une WNODE_SINGLE_INSTANCE en réponse à une demande de IRP_MN_QUERY_SINGLE_INSTANCE ou à générer un événement qui se compose d’une seule instance.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | wmistr.h (include Wmistr.h) |