Функция CmRegisterCallback (wdm.h)

  • Статья

Подпрограмма CmRegisterCallbackустарела для Windows Vista и более поздних версий операционной системы. Вместо этого используйте CmRegisterCallbackEx .

Подпрограмма CmRegisterCallback регистрирует подпрограмму RegistryCallback .

Синтаксис

NTSTATUS CmRegisterCallback(
  [in]           PEX_CALLBACK_FUNCTION Function,
  [in, optional] PVOID                 Context,
  [out]          PLARGE_INTEGER        Cookie
);

Параметры

[in] Function

Указатель на подпрограмму RegistryCallback для регистрации.

[in, optional] Context

Определенное драйвером значение, которое диспетчер конфигурации будет передавать в качестве параметра CallbackContext в подпрограмму RegistryCallback .

[out] Cookie

Указатель на переменную LARGE_INTEGER, получающую значение, идентифицирующее подпрограмму обратного вызова. При отмене регистрации процедуры обратного вызова передайте это значение в качестве параметра Cookieв CmUnRegisterCallback.

Возвращаемое значение

CmRegisterCallback возвращает STATUS_SUCCESS, если операция выполнена успешно, или соответствующий код ошибки NTSTATUS в случае сбоя.

Комментарии

Подпрограмма CmRegisterCallback доступна в Windows XP и более поздних версиях операционной системы. Для Windows Vista и более поздних версий операционной системы следует использовать CmRegisterCallbackEx .

Драйвер вызывает CmRegisterCallback для регистрации подпрограммы RegistryCallback , которая вызывается каждый раз, когда поток выполняет операцию с реестром.

Вызовите CmUnRegisterCallback , чтобы отменить регистрацию процедуры обратного вызова, зарегистрированной CmRegisterCallback .

Дополнительные сведения о CmRegisterCallback и фильтрации операций реестра см. в разделе Фильтрация вызовов реестра.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows XP и более поздних версиях Windows.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=APC_LEVEL
Правила соответствия DDI HwStorPortProhibitedDIs(storport), IrqlExApcLte2(wdm)

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

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback