struttura WNODE_EVENT_REFERENCE (wmistr.h)
La struttura WNODE_EVENT_REFERENCE contiene informazioni che WMI può usare per eseguire una query per un evento che supera il limite di dimensioni dell'evento impostato nel Registro di sistema.
Sintassi
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;
Members
WnodeHeader
Struttura WNODE_HEADER che contiene informazioni comuni a tutte le strutture WNODE_XXX , ad esempio le dimensioni del buffer, l'ID del provider, il GUID che rappresenta un blocco di dati associato a una richiesta e flag che forniscono informazioni sui dati WNODE_XXX passati o restituiti.
TargetGuid
Indica il GUID che rappresenta l'evento di cui eseguire la query.
TargetDataBlockSize
Indica le dimensioni dell'evento.
DUMMYUNIONNAME
DUMMYUNIONNAME.TargetInstanceIndex
Indica l'indice nell'elenco dei nomi di istanze statiche del driver per l'evento. Questo membro è valido solo se il blocco eventi è stato registrato con nomi di istanza statici e WNODE_FLAGS_STATIC_INSTANCE_NAMES è impostato in WnodeHeader.Flags.
DUMMYUNIONNAME.TargetInstanceName
Indica il nome dell'istanza dinamica dell'evento come stringa Unicode con conteggiata. Questo membro è valido solo se WNODE_FLAGS_STATIC_INSTANCE_NAMES è deselezionata in WnodeHeader.Flags e il blocco di eventi è stato registrato con nomi di istanza dinamici.
Commenti
Se la quantità di dati per un evento supera le dimensioni massime impostate nel Registro di sistema, un driver può generare un WNODE_EVENT_REFERENCE che specifica un WNODE_EVENT_ITEM su cui WMI può eseguire una query per ottenere l'evento. Per altre informazioni sulla definizione e la generazione di eventi WMI, vedere Implementazione di WMI.
Il membro ProviderId della struttura WNODE_HEADER da usare in una struttura WNODE_EVENT_REFERENCE deve essere inizializzato usando IoWMIDeviceObjectToProviderId.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | wmistr.h (include Wmistr.h) |