Función CmRegisterCallbackEx (wdm.h)
La rutina CmRegisterCallbackEx registra una rutina de RegistryCallback.
Sintaxis
NTSTATUS CmRegisterCallbackEx(
[in] PEX_CALLBACK_FUNCTION Function,
[in] PCUNICODE_STRING Altitude,
[in] PVOID Driver,
[in, optional] PVOID Context,
[out] PLARGE_INTEGER Cookie,
PVOID Reserved
);
Parámetros
[in] Function
Puntero a la rutina registryCallback de que se va a registrar.
[in] Altitude
Puntero a una estructura de UNICODE_STRING. Esta estructura debe contener una cadena que represente el de altitud del controlador de minifiltro que llama . Para obtener más información, vea Comentarios.
[in] Driver
Puntero a la estructura DRIVER_OBJECT que representa el controlador.
[in, optional] Context
Valor definido por el controlador que el administrador de configuración pasará como parámetro CallbackContext a la rutina de 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.
Reserved
Este parámetro está reservado para uso futuro.
Valor devuelto
cmRegisterCallbackEx devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta rutina podría devolver uno de los siguientes valores de NTSTATUS:
| Código devuelto | Descripción |
|---|---|
|
El controlador que llama u otro controlador ya ha registrado una rutina de RegistryCallback para la altitud especificada. |
|
Error al intentar asignar memoria. |
Observaciones
La rutina CmRegisterCallbackEx está disponible a partir de Windows Vista.
Un controlador puede llamar a CmRegisterCallback o CmRegisterCallbackEx para registrar una rutina RegistryCallback, que se llama cada vez que un subproceso realiza una operación en el registro.
El parámetro Altitud define la posición del controlador de minifiltro en relación con otros minifiltros de la pila de E/S cuando se carga el minifiltro. Microsoft administra la asignación de altitud a minifiltros. Para obtener más información sobre las altitudes, consulte grupos de orden de carga y altitud para controladores de minifiltro.
Llame a cmUnRegisterCallback para anular el registro de una rutina de devolución de llamada que CmRegisterCallbackEx registrado.
Para obtener más información sobre CmRegisterCallbackEx y filtrado de operaciones del Registro, consulte Filtrado de llamadas del Registro.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows Vista. |
| 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) |