structure WNODE_EVENT_REFERENCE (wmistr.h)
La structure WNODE_EVENT_REFERENCE contient des informations que WMI peut utiliser pour rechercher 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 du fournisseur, le GUID qui représente un bloc de données associé à une demande et des 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 d’instances statiques du pilote pour l’événement. Ce membre est valide uniquement si le bloc d’événements a été inscrit avec des noms d’instances statiques et WNODE_FLAGS_STATIC_INSTANCE_NAMES est défini dans WnodeHeader.Flags.
DUMMYUNIONNAME.TargetInstanceName
Indique le nom de l’instance dynamique 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 que le bloc d’événements a été inscrit avec des noms d’instances 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 un 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 deWMI .
Le ProviderId membre de la structure WNODE_HEADER à utiliser dans une structure de WNODE_EVENT_REFERENCE doit être initialisé à l’aide IoWMIDeviceObjectToProviderId.
Exigences
Exigence | Valeur |
---|---|
d’en-tête | wmistr.h (include Wmistr.h) |