Función CmRegisterCallback (wdm.h)
La rutina CmRegisterCallback está obsoletas para Windows Vista y versiones posteriores del sistema operativo. Use cmRegisterCallbackEx en su lugar.
La rutina CmRegisterCallback registra una rutina de RegistryCallback.
Sintaxis
NTSTATUS CmRegisterCallback(
[in] PEX_CALLBACK_FUNCTION Function,
[in, optional] PVOID Context,
[out] PLARGE_INTEGER Cookie
);
Parámetros
[in] Function
Puntero a la rutina registryCallback de que se va a registrar.
[in, optional] Context
Valor definido por el controlador que el administrador de configuración pasará como parámetro CallbackContext a la rutina RegistryCallback de
[out] Cookie
Puntero a una variable LARGE_INTEGER que recibe el valor que identifica la rutina de devolución de llamada. Al anular el registro de la rutina de devolución de llamada, pase este valor como parámetro Cookie a CmUnRegisterCallback.
Valor devuelto
CmRegisterCallback devuelve STATUS_SUCCESS si la operación se realiza correctamente o el código de error NTSTATUS adecuado si se produce un error.
Observaciones
La rutina CmRegisterCallback está disponible en Windows XP y versiones posteriores del sistema operativo. En el caso de Windows Vista y versiones posteriores del sistema operativo, debe usar CmRegisterCallbackEx en su lugar.
Un controlador llama a CmRegisterCallback para registrar una rutina registryCallback de, que se llama cada vez que un subproceso realiza una operación en el registro.
Llame a cmUnRegisterCallback para anular el registro de una rutina de devolución de llamada que cmRegisterCallback registrado.
Para obtener más información sobre CmRegisterCallback y filtrado de operaciones del Registro, consulte Filtrado de llamadas del Registro.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows XP y versiones posteriores de Windows. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | <=APC_LEVEL |
| reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlExApcLte2(wdm) |