Função IoWMISetNotificationCallback (wdm.h)
A rotina de IoWMISetNotificationCallback registra um retorno de chamada de notificação para um evento WMI.
Sintaxe
NTSTATUS IoWMISetNotificationCallback(
[in, out] PVOID Object,
[in] WMI_NOTIFICATION_CALLBACK Callback,
[in, optional] PVOID Context
);
Parâmetros
[in, out] Object
Ponteiro para um objeto de bloco de dados WMI. O chamador abre o objeto de bloco de dados para o evento WMI com a rotina de IoWMIOpenBlock. O objeto deve ser aberto com o WMIGUID_NOTIFICATION direito de acesso.
[in] Callback
Ponteiro para uma função do formulário:
XxxWmiNotificationCallback(PVOID Wnode, PVOID Context);
O WMI chama essa função para notificar o chamador de que o evento especificado ocorreu. O parâmetro Wnode da rotina de retorno de chamada aponta para a estrutura de WNODE_EVENT_ITEM retornada pelo driver que dispara o evento. O parâmetro Context da rotina de retorno de chamada aponta para o valor especificado no parâmetro contexto da rotina de IoWMISetNotificationCallback.
[in, optional] Context
Especifica o valor que o WMI passa para a rotina de retorno de chamada quando o evento ocorre.
Valor de retorno
Essa rotina retorna STATUS_SUCCESS com êxito e o código de erro NTSTATUS apropriado sobre falha.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |