structure REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION (wdm.h)

  • Article

La structure REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION contient des informations que la routine RegistryCallback d’un pilote peut utiliser pour libérer les ressources que le pilote a précédemment allouées pour le contexte associé à un objet de Registre.

Syntaxe

typedef struct _REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION {
  PVOID Object;
  PVOID ObjectContext;
  PVOID Reserved;
} REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION, *PREG_CALLBACK_CONTEXT_CLEANUP_INFORMATION;

Membres

Object

Pointeur vers l’objet de clé de Registre pour la clé à supprimer.

ObjectContext

Pointeur vers les informations de contexte définies par le pilote que le pilote a associées à un objet de Registre en appelant CmSetCallbackObjectContext.

Reserved

Ce membre est réservé pour un usage ultérieur.

Remarques

Cette structure est utilisée par la routine RegistryCallback . Lorsque le paramètre Argument1 de la routine RegistryCallback est RegNtCallbackObjectContextCleanup, le paramètre Argument2 est un pointeur vers une structure REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION .

La routine RegistryCallback du pilote reçoit une notification RegNtCallbackObjectContextCleanup lorsque le nombre de références de l’objet clé tombe à zéro (c’est-à-dire qu’il n’y a pas de handles ou de références de pointeur en attente vers l’objet clé).

En réponse à cette notification, la routine doit libérer toutes les ressources qu’elle a allouées pour le contexte de l’objet. La notification RegNtCallbackObjectContextCleanup se produit lorsque le pilote a appelé CmUnRegisterCallback ou que la routine RegistryCallback du pilote vient de terminer le traitement d’une notification RegNtPreKeyHandleClose .

Pour plus d’informations sur les opérations de filtrage du Registre, consultez Filtrage des appels du Registre.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows Vista.
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)

Voir aussi

CmSetCallbackObjectContext

CmUnRegisterCallback

RegistryCallback