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 |