Partager via


IoWMISetNotificationCallback, fonction (wdm.h)

La routine IoWMISetNotificationCallback inscrit un rappel de notification pour un événement WMI.

Syntaxe

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

Paramètres

[in, out] Object

Pointeur vers un objet de bloc de données WMI. L’appelant ouvre l’objet de bloc de données pour l’événement WMI avec la routine IoWMIOpenBlock. L’objet doit être ouvert avec le droit d’accès WMIGUID_NOTIFICATION.

[in] Callback

Pointeur vers une fonction du formulaire :

 XxxWmiNotificationCallback(PVOID Wnode, PVOID Context);

WMI appelle cette fonction pour avertir l’appelant que l’événement spécifié s’est produit. Le paramètre Wnode de la routine de rappel pointe vers la structure WNODE_EVENT_ITEM retournée par le pilote qui déclenche l’événement. Le paramètre Context de la routine de rappel pointe vers la valeur spécifiée dans le paramètre Context de la routine IoWMISetNotificationCallback.

[in, optional] Context

Spécifie la valeur que WMI transmet à la routine de rappel lorsque l’événement se produit.

Valeur de retour

Cette routine retourne STATUS_SUCCESS sur la réussite et le code d’erreur NTSTATUS approprié en cas d’échec.

Exigences

Exigence Valeur
plateforme cible Universel
d’en-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Voir aussi

IoWMIOpenBlock

WNODE_EVENT_ITEM