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 |