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

  • Статья

Подпрограмма CmUnRegisterCallback отменяет регистрацию подпрограммы RegistryCallback , зарегистрированной ранее в процедуре CmRegisterCallback или CmRegisterCallbackEx .

Синтаксис

NTSTATUS CmUnRegisterCallback(
  [in] LARGE_INTEGER Cookie
);

Параметры

[in] Cookie

Значение LARGE_INTEGER, определяющее отмену регистрации процедуры обратного вызова. CmRegisterCallback предоставил это значение при регистрации процедуры обратного вызова.

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

CmUnRegisterCallback возвращает STATUS_SUCCESS в случае успешного выполнения или соответствующий код ошибки NTSTATUS в случае сбоя. Если параметр Cookie не соответствует зарегистрированным подпрограммам обратного вызова, CmUnRegisterCallback возвращает STATUS_INVALID_PARAMETER.

Комментарии

Драйвер, вызывающий CmRegisterCallback или CmRegisterCallbackEx , должен вызвать CmUnRegisterCallback перед выгрузкой драйвера.

Драйвер не должен вызывать CmUnRegisterCallback из своей реализации подпрограммы RegistryCallback . Этот вызов приведет к взаимоблокировке.

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

Требования

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

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

CmRegisterCallback

CmRegisterCallbackEx

RegistryCallback