Funzione IoWMIWriteEvent (wdm.h)

  • Articolo

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
STATUS_SUCCESS
 Indica che WMI ha accodato correttamente l'evento per il recapito ai componenti WMI in modalità utente.
STATUS_UNSUCCESSFUL
 Indica che i servizi WMI non sono disponibili.
STATUS_BUFFER_OVERFLOW
 Indica che l'elemento dell'evento specificato supera le dimensioni massime consentite.
STATUS_INSUFFICIENT_RESOURCES
 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)

Vedi anche

IoWmiDeviceObjectToProviderId

WNODE_EVENT_ITEM