structure WNODE_EVENT_ITEM (wmistr.h)
La structure WNODE_EVENT_ITEM contient des données générées par un pilote pour un événement.
Syntaxe
typedef struct tagWNODE_EVENT_ITEM {
struct _WNODE_HEADER WnodeHeader;
} WNODE_EVENT_ITEM, *PWNODE_EVENT_ITEM;
Membres
WnodeHeader
Spécifie une 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 donnéesxxx WNODE_transmises ou retournées.
Remarques
Le membre WnodeHeader de la structure WNODE_EVENT_ITEM est suivi d’une structure dont le type dépend des indicateurs définis dans WnodeHeader. Les possibilités incluent WNODE_ALL_DATA, WNODE_SINGLE_INSTANCEet WNODE_SINGLE_ITEM. Pour plus d’informations sur les indicateurs, consultez WNODE_HEADER.
Le ProviderId membre de la structure WNODE_HEADER à utiliser dans une structure WNODE_EVENT_ITEM doit être initialisé à l’aide de IoWMIDeviceObjectToProviderId.
Un pilote génère uniquement les événements qu’il a précédemment activés en réponse à une demande de IRP_MN_ENABLE_EVENTS. Pour générer un événement, un pilote appelle IoWMIWriteEvent et transmet un pointeur au WNODE_EVENT_ITEM. WMI met en file d’attente l’événement pour la remise à tous les consommateurs de données inscrits pour cet événement.
Pour des performances optimales, les événements doivent être de petite taille. Toutefois, si la quantité de données d’un événement dépasse la taille maximale définie dans le Registre, un pilote peut passer un WNODE_EVENT_REFERENCE, que WMI utilise pour interroger les WNODE_EVENT_ITEMassociées. Pour plus d’informations sur la définition et la génération d’événements WMI, consultez Windows Management Instrumentation.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | wmistr.h (include Wmistr.h) |