ObRegisterCallbacks, fonction (wdm.h)
La routine ObRegisterCallbacks inscrit une liste de routines de rappel pour les opérations de thread, de processus et de handle de bureau.
Syntaxe
NTSTATUS ObRegisterCallbacks(
[in] POB_CALLBACK_REGISTRATION CallbackRegistration,
[out] PVOID *RegistrationHandle
);
Paramètres
[in] CallbackRegistration
Pointeur vers une structure de OB_CALLBACK_REGISTRATION qui spécifie la liste des routines de rappel et d’autres informations d’inscription.
[out] RegistrationHandle
Pointeur vers une variable qui reçoit une valeur qui identifie l’ensemble des routines de rappel inscrites. L’appelant transmet cette valeur à la routine ObUnRegisterCallbacks pour annuler l’inscription du jeu de rappels.
Valeur retournée
ObRegisterCallbacks retourne une valeur NTSTATUS. Cette routine peut retourner l’une des valeurs suivantes :
Code de retour | Description |
---|---|
|
Les routines de rappel spécifiées sont inscrites auprès du système. |
|
Le pilote appelant ou un autre pilote a déjà inscrit des routines de rappel pour l’altitude spécifiée par CallBackRegistration->Altitude . Pour plus d’informations sur cette altitude, consultez la description du membre Altitude dans OB_CALLBACK_REGISTRATION. |
|
Un ou plusieurs des paramètres spécifiés dans l’inscription n’étaient pas valides. ObRegisterCallbacks peut renvoyer cette erreur, par exemple, si une valeur non valide pour CallBackRegistration->Version est spécifiée ou si l’inscription est tentée pour les types d’objets qui ne prennent pas en charge les routines de rappel. |
|
Les routines de rappel ne résident pas dans une image binaire du noyau signé. |
|
Une tentative d’allocation de mémoire a échoué. |
Remarques
Un pilote doit annuler l’inscription de toutes les routines de rappel avant son déchargement. Vous pouvez annuler l’inscription de la routine de rappel en appelant la routine ObUnRegisterCallbacks .
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible à partir de Windows Vista avec Service Pack 1 (SP1) et Windows Server 2008. |
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 |