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 例程的驱动程序定义上下文。

返回值

表示注册的句柄。 必须在调用 IoUnRegisterBootDriverCallback 例程中以输入参数的形式提供此句柄,以取消注册 BOOT_DRIVER_CALLBACK_FUNCTION 例程。

言论

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

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

要求

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

另请参阅

BDCB_CALLBACK_TYPE

BDCB_IMAGE_INFORMATION

IoUnRegisterBootDriverCallback