structure WNODE_EVENT_REFERENCE (wmistr.h)
La structure WNODE_EVENT_REFERENCE contient des informations que WMI peut utiliser pour interroger un événement qui dépasse la limite de taille d’événement définie dans le Registre.
Syntaxe
typedef struct tagWNODE_EVENT_REFERENCE {
struct _WNODE_HEADER WnodeHeader;
GUID TargetGuid;
ULONG TargetDataBlockSize;
union {
ULONG TargetInstanceIndex;
WCHAR TargetInstanceName[];
} DUMMYUNIONNAME;
} WNODE_EVENT_REFERENCE, *PWNODE_EVENT_REFERENCE;
Membres
WnodeHeader
Structure WNODE_HEADER qui contient des informations communes à toutes les structures WNODE_XXX , telles que la taille de la mémoire tampon, l’ID de fournisseur, 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 transmises ou retournées.
TargetGuid
Indique le GUID qui représente l’événement à interroger.
TargetDataBlockSize
Indique la taille de l’événement.
DUMMYUNIONNAME
DUMMYUNIONNAME.TargetInstanceIndex
Indique l’index dans la liste des noms de instance statiques du pilote pour l’événement. Ce membre est valide uniquement si le bloc d’événements a été inscrit avec des noms de instance statiques et si WNODE_FLAGS_STATIC_INSTANCE_NAMES est défini dans WnodeHeader.Flags.
DUMMYUNIONNAME.TargetInstanceName
Indique le nom dynamique instance de l’événement sous la forme d’une chaîne Unicode comptée. Ce membre n’est valide que si WNODE_FLAGS_STATIC_INSTANCE_NAMES est clair dans WnodeHeader.Flags et si le bloc d’événements a été inscrit avec des noms de instance dynamiques.
Remarques
Si la quantité de données d’un événement dépasse la taille maximale définie dans le Registre, un pilote peut générer une WNODE_EVENT_REFERENCE qui spécifie un WNODE_EVENT_ITEM que WMI peut interroger pour obtenir l’événement. Pour plus d’informations sur la définition et la génération d’événements WMI, consultez Implémentation de WMI.
Le membre ProviderId de la structure WNODE_HEADER à utiliser dans une structure de WNODE_EVENT_REFERENCE doit être initialisé à l’aide de IoWMIDeviceObjectToProviderId.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | wmistr.h (inclure Wmistr.h) |