structure REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION (wdm.h)
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) |