Compartir a través de

Función ObRegisterCallbacks (wdm.h)

  • Artículo

La rutina ObRegisterCallbacks registra una lista de rutinas de devolución de llamada para las operaciones de subproceso, proceso y controlador de escritorio.

Sintaxis

NTSTATUS ObRegisterCallbacks(
  [in]  POB_CALLBACK_REGISTRATION CallbackRegistration,
  [out] PVOID                     *RegistrationHandle
);

Parámetros

[in] CallbackRegistration

Puntero a una estructura de OB_CALLBACK_REGISTRATION que especifica la lista de rutinas de devolución de llamada y otra información de registro.

[out] RegistrationHandle

Puntero a una variable que recibe un valor que identifica el conjunto de rutinas de devolución de llamada registradas. El autor de la llamada pasa este valor a la rutina ObUnRegisterCallbacks para anular el registro del conjunto de devoluciones de llamada.

Valor devuelto

ObRegisterCallbacks devuelve un valor NTSTATUS. Esta rutina puede devolver uno de los siguientes valores:

Código devuelto Descripción
STATUS_SUCCESS
 Las rutinas de devolución de llamada especificadas se registran con el sistema.
STATUS_FLT_INSTANCE_ALTITUDE_COLLISION
 El controlador de llamada u otro controlador ya ha registrado rutinas de devolución de llamada para la altitud que especifica CallBackRegistration->Altitude . Para obtener más información sobre esta altitud, vea la descripción del miembro Altitude en OB_CALLBACK_REGISTRATION.
STATUS_INVALID_PARAMETER
 Uno o varios de los parámetros especificados en el registro no eran válidos. ObRegisterCallbacks podría devolver este error, por ejemplo, si se especifica un valor no válido para CallBackRegistration->Version o si se intenta registrar para tipos de objetos que no admiten rutinas de devolución de llamada.
STATUS_ACCESS_DENIED
 Las rutinas de devolución de llamada no residen en una imagen binaria de kernel firmada.
STATUS_INSUFFICIENT_RESOURCES
 Error al tratar de asignar memoria.

Comentarios

Un controlador debe anular el registro de todas las rutinas de devolución de llamada antes de descargarla. Puede anular el registro de la rutina de devolución de llamada llamando a la rutina ObUnRegisterCallbacks .

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows Vista con Service Pack 1 (SP1) y Windows Server 2008.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Consulte también

OB_CALLBACK_REGISTRATION

ObUnRegisterCallbacks