Функция IoRegisterBootDriverCallback (ntddk.h)

Подпрограмма IoRegisterBootDriverCallback регистрирует подпрограмму 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.

Возвращаемое значение

Дескриптор, представляющий регистрацию. Этот дескриптор должен быть указан в качестве входного параметра в вызове процедуры IoUnRegisterBootDriverCallback , которая отменяет регистрацию BOOT_DRIVER_CALLBACK_FUNCTION подпрограммы.

Комментарии

Драйверы запуска загрузки должны вызвать IoUnRegisterBootDriverCallback и передать возвращенный дескриптор, чтобы отменить регистрацию обратного вызова драйвера boot-start, прежде чем Windows выгрузит их.

Любая ошибка, возвращаемая обратным вызовом обновления состояния, считается неустранимой и приводит к проверка системной ошибки. Кроме того, если обратный вызов инициализации образа возвращает ошибку, образ драйвера обрабатывается как неизвестный. Чтобы получать уведомления об операциях инициализации драйвера загрузки и запуска, драйвер раннего запуска защиты от вредоносных программ (ELAM) может вызвать IoRegisterBootDriverCallback для регистрации процедуры BOOT_DRIVER_CALLBACK_FUNCTION .

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.
Целевая платформа	Универсальное
Верхняя часть	ntddk.h (включая Ntddk.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

См. также раздел

BDCB_CALLBACK_TYPE

BDCB_IMAGE_INFORMATION

IoUnRegisterBootDriverCallback