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 |