Função IoRegisterBootDriverCallback (ntddk.h)
A rotina IoRegisterBootDriverCallback registra uma rotina BOOT_DRIVER_CALLBACK_FUNCTION a ser chamada durante a inicialização de um driver de inicialização e suas DLLs dependentes.
Sintaxe
PVOID IoRegisterBootDriverCallback(
[in] PBOOT_DRIVER_CALLBACK_FUNCTION CallbackFunction,
[in, optional] PVOID CallbackContext
);
Parâmetros
[in] CallbackFunction
Um ponteiro para a rotina de BOOT_DRIVER_CALLBACK_FUNCTION a ser chamada ao inicializar um driver de inicialização ou DLL.
[in, optional] CallbackContext
Um contexto definido pelo driver a ser passado para a rotina BOOT_DRIVER_CALLBACK_FUNCTION apontada por CallbackFunction.
Retornar valor
Um identificador que representa o registro. Esse identificador deve ser fornecido como um parâmetro de entrada na chamada para a rotina IoUnRegisterBootDriverCallback que cancela o registro da rotina BOOT_DRIVER_CALLBACK_FUNCTION .
Comentários
Os drivers de inicialização devem chamar IoUnRegisterBootDriverCallback e passar o identificador retornado para cancelar o registro do retorno de chamada do driver de inicialização antes que o Windows os descarregue.
Qualquer erro retornado de um retorno de chamada de atualização status é tratado como fatal e leva a um bug do sistema marcar. Além disso, se um retorno de chamada de imagem de inicialização retornar um erro, a imagem do driver será tratada como desconhecida. Para ser notificado sobre as operações de inicialização do driver de inicialização, um driver ELAM ( antimalware) de inicialização antecipada pode chamar IoRegisterBootDriverCallback para registrar uma rotina de BOOT_DRIVER_CALLBACK_FUNCTION .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8. |
| Plataforma de Destino | Universal |
| Cabeçalho | ntddk.h (inclua Ntddk.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |