struttura WNODE_EVENT_ITEM (wmistr.h)

Articolo
03/05/2024

La struttura WNODE_EVENT_ITEM contiene i dati generati da un driver per un evento.

Sintassi

typedef struct tagWNODE_EVENT_ITEM {
  struct _WNODE_HEADER WnodeHeader;
} WNODE_EVENT_ITEM, *PWNODE_EVENT_ITEM;

Members

WnodeHeader

Specifica una struttura WNODE_HEADER che contiene informazioni comuni a tutte le strutture WNODE_XXX , ad esempio le dimensioni del buffer, il GUID che rappresenta un blocco di dati associato a una richiesta e flag che forniscono informazioni sui dati WNODE_XXX passati o restituiti.

Commenti

Il membro WnodeHeader della struttura WNODE_EVENT_ITEM è seguito da una struttura il cui tipo dipende dai flag impostati in WnodeHeader. Le possibilità includono WNODE_ALL_DATA, WNODE_SINGLE_INSTANCE e WNODE_SINGLE_ITEM. Per altre informazioni sui flag, vedere WNODE_HEADER.

Il membro ProviderId della struttura WNODE_HEADER da usare in una struttura WNODE_EVENT_ITEM deve essere inizializzato usando IoWMIDeviceObjectToProviderId.

Un driver genera solo gli eventi abilitati in precedenza in risposta a una richiesta di IRP_MN_ENABLE_EVENTS . Per generare un evento, un driver chiama IoWMIWriteEvent e passa un puntatore al WNODE_EVENT_ITEM. WMI accoda l'evento per il recapito a tutti i consumer di dati registrati per tale evento.

Per ottenere prestazioni ottimali, gli eventi devono avere dimensioni ridotte. Tuttavia, se la quantità di dati per un evento supera le dimensioni massime definite nel Registro di sistema, un driver può passare un WNODE_EVENT_REFERENCE, che WMI usa per eseguire una query per il WNODE_EVENT_ITEM correlato. Per altre informazioni sulla definizione e la generazione di eventi WMI, vedere Strumentazione gestione Windows.