structure WNODE_EVENT_ITEM (wmistr.h)

Article
02/27/2024

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 de 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 les indicateurs qui fournissent des informations sur les données WNODE_XXX 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 les WNODE_ALL_DATA, les WNODE_SINGLE_INSTANCE et les WNODE_SINGLE_ITEM. Pour plus d’informations sur les indicateurs, consultez WNODE_HEADER.

Le membre ProviderId de la structure WNODE_HEADER pour une utilisation dans une structure de 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 passe un pointeur vers le 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 de meilleures performances, 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 une WNODE_EVENT_REFERENCE, que WMI utilise pour interroger les WNODE_EVENT_ITEM associées. Pour plus d’informations sur la définition et la génération d’événements WMI, consultez Windows Management Instrumentation.