ObRegisterCallbacks, fonction (wdm.h)

  • Article

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
STATUS_SUCCESS
 Les routines de rappel spécifiées sont inscrites auprès du système.
STATUS_FLT_INSTANCE_ALTITUDE_COLLISION
 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.
STATUS_INVALID_PARAMETER
 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.
STATUS_ACCESS_DENIED
 Les routines de rappel ne résident pas dans une image binaire du noyau signé.
STATUS_INSUFFICIENT_RESOURCES
 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

Voir aussi

OB_CALLBACK_REGISTRATION

ObUnRegisterCallbacks