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 如果作成功或相应的 NTSTATUS 错误代码(如果作失败)返回STATUS_SUCCESS。
言论
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) |