Funzione IoWMIWriteEvent (wdm.h)
La routine IoWMIWriteEvent recapita un determinato evento ai componenti WMI in modalità utente per la notifica.
Sintassi
NTSTATUS IoWMIWriteEvent(
[in, out] PVOID WnodeEventItem
);
Parametri
[in, out] WnodeEventItem
Puntatore a una struttura WNODE_EVENT_ITEM da recapitare ai componenti WMI in modalità utente che hanno richiesto la notifica dell'evento.
Valore restituito
IoWMIWriteEvent restituisce un codice di stato dall'elenco seguente:
| Codice restituito | Descrizione |
|---|---|
|
Indica che WMI ha accodato correttamente l'evento per il recapito ai componenti WMI in modalità utente. |
|
Indica che i servizi WMI non sono disponibili. |
|
Indica che l'elemento dell'evento specificato supera le dimensioni massime consentite. |
|
Indica che le risorse insufficienti erano disponibili per WMI per accodare l'evento per il recapito. |
Commenti
La struttura WNODE_EVENT_ITEM allocata dal chiamante e passata in WnodeEventItem deve essere allocata da un pool non di paging. Se IoWMIWriteEvent restituisce STATUS_SUCCESS, la memoria per l'elemento dell'evento verrà liberata automaticamente dal sistema. Se IoWMIWriteEvent restituisce qualsiasi valore diverso da STATUS_SUCCESS, è responsabilità del chiamante liberare il buffer.
I driver devono chiamare solo IoWMIWriteEvent per gli eventi abilitati per WMI. In questo modo si garantisce che sia presente un consumer di eventi in attesa di indicazioni su tale evento.
I chiamanti di questa routine devono essere in esecuzione in IRQL <= APC_LEVEL, con un'eccezione. Quando il membro Flags della struttura WNODE_HEADER contiene WNODE_FLAG_TRACED_GUID, IoWMIWriteEvent può essere chiamato in qualsiasi IRQL. La struttura WNODE_HEADER è un membro della struttura WNODE_EVENT_ITEM a cui punta il parametro WnodeEventItem .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL (vedere la sezione Osservazioni) |