Функция 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 для регистрации подпрограммы РеестраCallback RegistryCallback, которая вызывается каждый раз, когда поток выполняет операцию в реестре.

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows XP и более поздних версиях Windows.
целевая платформа	Всеобщий
заголовка	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<=APC_LEVEL
правил соответствия DDI	HwStorPortProhibitedDIs(storport), IrqlExApcLte2(wdm)

См. также

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback