Função IoWMISetNotificationCallback (wdm.h)

  • Artigo

A rotina 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 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 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 Context da rotina IoWMISetNotificationCallback .

[in, optional] Context

Especifica o valor que o WMI passa para a rotina de retorno de chamada quando o evento ocorre.

Retornar valor

Essa rotina retorna STATUS_SUCCESS com êxito e o código de erro NTSTATUS apropriado em caso de falha.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Confira também

IoWMIOpenBlock

WNODE_EVENT_ITEM