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 例程。

規格需求

另請參閱

BDCB_CALLBACK_TYPE

BDCB_IMAGE_INFORMATION

IoUnRegisterBootDriverCallback