ExCreateCallback, fonction (wdm.h)

La routine ExCreateCallback crée un objet de rappel ou ouvre un objet de rappel existant pour le compte de l’appelant.

Syntaxe

NTSTATUS ExCreateCallback(
  [out] PCALLBACK_OBJECT   *CallbackObject,
  [in]  POBJECT_ATTRIBUTES ObjectAttributes,
  [in]  BOOLEAN            Create,
  [in]  BOOLEAN            AllowMultipleCallbacks
);

Paramètres

[out] CallbackObject

Pointeur vers un emplacement qui reçoit un pointeur vers un objet de rappel, qui est une structure système opaque. Si l’appel ExCreateCall back réussit, la routine écrit l’adresse de l’objet de rappel nouvellement créé ou ouvert à cet emplacement. Le pointeur d’objet de rappel obtenu à partir de cette routine peut être fourni en tant que paramètre à la routine ExRegisterCallback ou ExNotifyCallback routine.

[in] ObjectAttributes

Pointeur vers une structure OBJECT_ATTRIBUTES qui contient les attributs de l’objet de rappel. Cette structure a été précédemment initialisée par la routine InitializeObjectAttributes.

[in] Create

Indique s’il faut créer un objet de rappel. Défini sur TRUE pour créer un objet de rappel si l’objet demandé ne peut pas être ouvert. Sinon, définissez la valeur FALSE.

[in] AllowMultipleCallbacks

Indique si un objet de rappel nouvellement créé doit autoriser plusieurs routines de rappel inscrites. Définissez la valeur TRUE pour autoriser plusieurs routines de rappel inscrites. Sinon, définissez la valeur FALSE. Ce paramètre est ignoré lorsque Create est FALSE ou lors de l’ouverture d’un objet existant.

Valeur de retour

ExCreateCallback retourne STATUS_SUCCESS si un objet de rappel a été ouvert ou créé. Sinon, il retourne un code d’erreur NTSTATUS pour indiquer la nature de l’échec.

Remarques

Un pilote appelle ExCreateCallback pour créer un objet de rappel ou pour ouvrir un objet de rappel existant. Une fois l’objet créé ou ouvert, d’autres composants peuvent appeler la routine ExRegisterCallback pour inscrire des routines de rappel avec l’objet de rappel.

Avant d’appeler ExCreateCallback, le pilote doit appeler InitializeObjectAttributes pour initialiser la structure OBJECT_ATTRIBUTES de l’objet de rappel. Les objets de rappel non nommés ne sont pas autorisés. L’appelant doit spécifier un nom pour l’objet ; sinon, l’appel échoue avec STATUS_UNSUCCESSFUL. L’appelant doit spécifier l’attribut OBJ_PERMANENT dans l’objet de rappel pour empêcher la suppression de l’objet avant de pouvoir être inscrit auprès du gestionnaire d’objets. L’appelant doit également spécifier d’autres attributs, tels que OBJ_CASE_INSENSITIVE, qui peuvent être nécessaires.

Lorsque toutes les opérations ont été effectuées avec l’objet de rappel, le pilote doit supprimer l’objet pour empêcher une fuite de mémoire. Pour plus d’informations sur la suppression d’un objet créé avec l’attribut d’objet OBJ_PERMANENT, consultez ObDereferenceObject.

Le tableau suivant montre les objets de rappel créés par le système d’exploitation pour une utilisation par les pilotes.

Pour plus d’informations sur les objets de rappel, consultez objets de rappel.

Exigences

Voir aussi

ExNotifyCallback

ExRegisterCallback

InitializeObjectAttributes

ObDereferenceObject