通过

IoRegisterBootDriverCallback 函数 (ntddk.h)

  • 项目

IoRegisterBootDriverCallback 例程注册在初始化启动驱动程序及其依赖 DLL 期间调用的BOOT_DRIVER_CALLBACK_FUNCTION例程。

语法

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

参数

[in] CallbackFunction

指向初始化启动驱动程序或 DLL 时要调用 的BOOT_DRIVER_CALLBACK_FUNCTION 例程的指针。

[in, optional] CallbackContext

要传递给 CallbackFunction 指向的BOOT_DRIVER_CALLBACK_FUNCTION例程的驱动程序定义的上下文。

返回值

表示注册的句柄。 在调用取消注册BOOT_DRIVER_CALLBACK_FUNCTION例程的 IoUnRegisterBootDriverCallback 例程时，必须将此句柄作为输入参数提供。

注解

启动驱动程序必须在 Windows 卸载启动驱动程序之前调用 IoUnRegisterBootDriverCallback 并传递返回的句柄以注销启动驱动程序回调。

状态更新回调返回的任何错误都被视为严重错误，并导致系统 bug 检查。 此外，如果初始化映像回调返回错误，驱动程序的映像将被视为未知。 若要收到启动驱动程序初始化操作的通知， 提前启动反恶意软件 (ELAM) 驱动程序可以调用 IoRegisterBootDriverCallback 来注册 BOOT_DRIVER_CALLBACK_FUNCTION 例程。

要求

要求 值
最低受支持的客户端 从Windows 8开始可用。
目标平台 通用
标头 ntddk.h (包括 Ntddk.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

另请参阅

BDCB_CALLBACK_TYPE

BDCB_IMAGE_INFORMATION

IoUnRegisterBootDriverCallback