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 des 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 à supprimer.
ObjectContext
Pointeur vers les informations de contexte définies par le pilote associées à un objet de Registre en appelant CmSetCallbackObjectContext.
Reserved
Ce membre est réservé à une utilisation ultérieure.
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é passe à zéro (c’est-à-dire qu’il n’y a pas de handles ou de références de pointeur en attente à 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 appels de Registre de filtrage.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows Vista. |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |