Partilhar via


Função IoRegisterBootDriverCallback (ntddk.h)

A rotina de 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 de BOOT_DRIVER_CALLBACK_FUNCTION apontada pelo CallbackFunction.

Valor de retorno

Um identificador que representa o registro. Esse identificador deve ser fornecido como um parâmetro de entrada na chamada para o IoUnRegisterBootDriverCallback rotina que cancela o registro da rotina de BOOT_DRIVER_CALLBACK_FUNCTION.

Observações

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 de status é tratado como fatal e leva a uma verificação de bugs do sistema. Além disso, se um retorno de chamada de imagem inicializar 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 de antimalware (ELAM) de inicialização antecipada pode chamar IoRegisterBootDriverCallback para registrar uma rotina de BOOT_DRIVER_CALLBACK_FUNCTION.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível a partir do Windows 8.
da Plataforma de Destino Universal
cabeçalho ntddk.h (inclua Ntddk.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Consulte também

BDCB_CALLBACK_TYPE

BDCB_IMAGE_INFORMATION

IoUnRegisterBootDriverCallback