Функция 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) |