структура REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION (wdm.h)
Структура REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION содержит сведения, которые подпрограмма RegistryCallback драйвера может использовать для освобождения ресурсов, ранее выделенных драйвером для контекста, связанного с объектом реестра.
Синтаксис
typedef struct _REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION {
PVOID Object;
PVOID ObjectContext;
PVOID Reserved;
} REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION, *PREG_CALLBACK_CONTEXT_CLEANUP_INFORMATION;
Члены
Object
Указатель на объект раздела реестра для удаляемого раздела.
ObjectContext
Указатель на определяемые драйвером контекстные сведения, связанные драйвером с объектом реестра путем вызова CmSetCallbackObjectContext.
Reserved
Этот элемент зарезервирован для использования в будущем.
Комментарии
Эта структура используется подпрограммой RegistryCallback . Если параметр Argument1 для подпрограммы RegistryCallback имеет значение RegNtCallbackObjectContextCleanup, параметр Argument2 является указателем на структуру REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION .
Подпрограмма RegistryCallback драйвера будет получать уведомление RegNtCallbackObjectContextCleanup , когда число ссылок на объект ключа падает до нуля (т. е. отсутствуют незавершенные дескрипторы или ссылки указателя на объект ключа).
В ответ на это уведомление подпрограмма должна освободить все ресурсы, выделенные для контекста объекта. Уведомление RegNtCallbackObjectContextCleanup возникает, когда драйвер вызвал CmUnRegisterCallback или подпрограмма RegistryCallback драйвера только что завершила обработку уведомления RegNtPreKeyHandleClose .
Дополнительные сведения об операциях фильтрации реестра см. в разделе Фильтрация вызовов реестра.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно начиная с Windows Vista. |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |