Partager via


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)

Voir aussi

IoWMIDeviceObjectToProviderId

WNODE_EVENT_ITEM

WNODE_HEADER