Fonction IoWMISetNotificationCallback (wdm.h)

  • Article

La routine IoWMISetNotificationCallback enregistre 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 retournée

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

Configuration requise

Condition requise Valeur
Plateforme cible Universal
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