Поделиться через

структура 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)

См. также раздел

CmSetCallbackObjectContext

CmUnRegisterCallback

RegistryCallback