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 |