Функция IoRegisterBootDriverCallback (ntddk.h)
Программа IoRegisterBootBootDriverCallback регистрирует процедуру BOOT_DRIVER_CALLBACK_FUNCTION для вызова во время инициализации драйвера начального запуска и зависимых библиотек DLL.
Синтаксис
PVOID IoRegisterBootDriverCallback(
[in] PBOOT_DRIVER_CALLBACK_FUNCTION CallbackFunction,
[in, optional] PVOID CallbackContext
);
Параметры
[in] CallbackFunction
Указатель на подпрограмму BOOT_DRIVER_CALLBACK_FUNCTION для вызова при инициализации драйвера начального запуска или библиотеки DLL.
[in, optional] CallbackContext
Определяемый драйвером контекст, передаваемый в подпрограмму BOOT_DRIVER_CALLBACK_FUNCTION, на который указывает CallbackFunction.
Возвращаемое значение
Дескриптор, представляющий регистрацию. Этот дескриптор должен быть предоставлен в качестве входного параметра в вызове IoUnRegisterBootBootDriverCallback подпрограммы, которая отменяет регистрацию подпрограммы BOOT_DRIVER_CALLBACK_FUNCTION.
Замечания
Драйверы начальной загрузки должны вызывать IoUnRegisterBootDriverCall back и передавать возвращенный дескриптор для отмены регистрации обратного вызова драйвера начальной загрузки перед выгрузкой Windows.
Любая ошибка, возвращаемая из обратного вызова обновления состояния, рассматривается как неустранимая и приводит к проверке системной ошибки. Кроме того, если обратный вызов изображения инициализации возвращает ошибку, образ драйвера рассматривается как неизвестный. Чтобы получать уведомления о операциях инициализации драйвера начальной загрузки, драйвер ранних запусков вредоносных программ (ELAM) может вызывать IoRegisterBootBootDriverCallback для регистрации подпрограммы BOOT_DRIVER_CALLBACK_FUNCTION.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 8. |
| целевая платформа | Всеобщий |
| заголовка | ntddk.h (include Ntddk.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |