Función CmRegisterCallbackEx (wdm.h)
La rutina CmRegisterCallbackEx registra una rutina 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 que se va a registrar.
[in] Altitude
Puntero a una estructura UNICODE_STRING . Esta estructura debe contener una cadena que representa la altitud del controlador de minifiltro que llama. Para obtener más información, vea la sección 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 RegistryCallback .
[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 se reserva 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 NTSTATUS :
| Código devuelto | Descripción |
|---|---|
|
El controlador que llama u otro controlador ya ha registrado una rutina RegistryCallback para la altitud especificada. |
|
Error al tratar de asignar memoria. |
Comentarios
La rutina CmRegisterCallbackEx está disponible a partir de Windows Vista.
Un controlador puede llamar a CmRegisterCallback o CmRegisterCallbackEx para registrar una rutina RegistryCallback , a la que se llama cada vez que un subproceso realiza una operación en el registro.
El parámetro Altitude 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 altitudes a minifiltros. Para obtener más información sobre las altitudes, vea Grupos de pedidos de carga y altitudes para controladores de minifiltro.
Llame a CmUnRegisterCallback para anular el registro de una rutina de devolución de llamada registrada por CmRegisterCallbackEx .
Para obtener más información sobre CmRegisterCallbackEx y filtrar las operaciones del Registro, consulte Filtrado de llamadas del Registro.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows Vista. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <=APC_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlExApcLte2(wdm) |