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）
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=APC_LEVEL
DDI 符合性规则 HwStorPortProhibitedDDI (storport) ， IrqlExApcLte2 (wdm)

另请参阅

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback