Función IoRegisterBootDriverCallback (ntddk.h)

La rutina IoRegisterBootDriverCallback registra una rutina de BOOT_DRIVER_CALLBACK_FUNCTION a la que se llamará durante la inicialización de un controlador de arranque y sus archivos DLL dependientes.

Sintaxis

PVOID IoRegisterBootDriverCallback(
  [in]           PBOOT_DRIVER_CALLBACK_FUNCTION CallbackFunction,
  [in, optional] PVOID                          CallbackContext
);

Parámetros

[in] CallbackFunction

Puntero a la rutina de BOOT_DRIVER_CALLBACK_FUNCTION que se va a llamar al inicializar un controlador o DLL de arranque.

[in, optional] CallbackContext

Contexto definido por el controlador que se va a pasar a la rutina de BOOT_DRIVER_CALLBACK_FUNCTION a la que apunta CallbackFunction.

Valor devuelto

Identificador que representa el registro. Este identificador debe proporcionarse como parámetro de entrada en la llamada a la rutina IoUnRegisterBootDriverCallback que anula el registro de la rutina BOOT_DRIVER_CALLBACK_FUNCTION .

Comentarios

Los controladores de arranque deben llamar a IoUnRegisterBootDriverCallback y pasar el identificador devuelto para anular el registro de la devolución de llamada del controlador de arranque antes de que Windows los descargue.

Cualquier error devuelto desde una devolución de llamada de actualización de estado se trata como grave y conduce a una comprobación de errores del sistema. Además, si una devolución de llamada de inicialización de imagen devuelve un error, la imagen del controlador se trata como desconocida. Para recibir una notificación de las operaciones de inicialización del controlador de arranque, un controlador antimalware (ELAM) de inicio temprano puede llamar a IoRegisterBootDriverCallback para registrar una rutina de BOOT_DRIVER_CALLBACK_FUNCTION .

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 8.
Plataforma de destino	Universal
Encabezado	ntddk.h (incluya Ntddk.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Consulte también

BDCB_CALLBACK_TYPE

BDCB_IMAGE_INFORMATION

IoUnRegisterBootDriverCallback