Función CmRegisterCallbackEx (wdm.h)

  • Artículo

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
STATUS_FLT_INSTANCE_ALTITUDE_COLLISION
 El controlador que llama u otro controlador ya ha registrado una rutina RegistryCallback para la altitud especificada.
STATUS_INSUFFICIENT_RESOURCES
 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)

Consulte también

CmRegisterCallback

CmUnRegisterCallback

DRIVER_OBJECT

RegistryCallback

UNICODE_STRING