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 卸除開機啟動驅動程式回呼之前取消註冊。
從狀態更新回呼傳回的任何錯誤都會被視為嚴重錯誤,並導致系統錯誤檢查。 此外,如果初始化映像回呼傳回錯誤,驅動程式的映像會被視為未知。 若要收到啟動驅動程式初始化作業的通知,早期啟動反惡意代碼 (ELAM) 驅動程式可以呼叫 IoRegisterBootDriverCallback 來註冊 BOOT_DRIVER_CALLBACK_FUNCTION 例程。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 8 開始提供。 |
目標平臺 | 普遍 |
標頭 | ntddk.h (包括 Ntddk.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |