Funzione IoWMISetNotificationCallback (wdm.h)

La routine IoWMISetNotificationCallback registra un callback di notifica per un evento WMI.

Sintassi

NTSTATUS IoWMISetNotificationCallback(
  [in, out]      PVOID                     Object,
  [in]           WMI_NOTIFICATION_CALLBACK Callback,
  [in, optional] PVOID                     Context
);

Parametri

[in, out] Object

Puntatore a un oggetto blocco di dati WMI. Il chiamante apre l'oggetto blocco dati per l'evento WMI con la routine IoWMIOpenBlock . L'oggetto deve essere aperto con il diritto di accesso WMIGUID_NOTIFICATION.

[in] Callback

Puntatore a una funzione del form:

 XxxWmiNotificationCallback(PVOID Wnode, PVOID Context);

WMI chiama questa funzione per notificare al chiamante che si è verificato l'evento specificato. Il parametro Wnode della routine di callback punta alla struttura WNODE_EVENT_ITEM restituita dal driver che attiva l'evento. Il parametro Context della routine di callback punta al valore specificato nel parametro Context della routine IoWMISetNotificationCallback .

[in, optional] Context

Specifica il valore che WMI passa alla routine di callback quando si verifica l'evento.

Valore restituito

Questa routine restituisce STATUS_SUCCESS in caso di esito positivo e il codice di errore NTSTATUS appropriato in caso di errore.

Requisiti

Vedi anche

IoWMIOpenBlock

WNODE_EVENT_ITEM