Função IoRegisterBootDriverCallback (ntddk.h)

  • Artigo

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

Confira também

BDCB_CALLBACK_TYPE

BDCB_IMAGE_INFORMATION

IoUnRegisterBootDriverCallback