IoRegisterBootDriverCallback-Funktion (ntddk.h)

Die IoRegisterBootDriverCallback-Routine registriert eine BOOT_DRIVER_CALLBACK_FUNCTION Routine, die während der Initialisierung eines Starttreibers und seiner abhängigen DLLs aufgerufen werden soll.

Syntax

PVOID IoRegisterBootDriverCallback(
  [in]           PBOOT_DRIVER_CALLBACK_FUNCTION CallbackFunction,
  [in, optional] PVOID                          CallbackContext
);

Parameter

[in] CallbackFunction

Ein Zeiger auf die BOOT_DRIVER_CALLBACK_FUNCTION Routine, die beim Initialisieren eines Starttreibers oder einer DLL aufgerufen werden soll.

[in, optional] CallbackContext

Ein treiberdefinierter Kontext, der an die BOOT_DRIVER_CALLBACK_FUNCTION Routine übergeben werden soll, auf die callbackFunction verweist.

Rückgabewert

Ein Handle, das die Registrierung darstellt. Dieses Handle muss als Eingabeparameter im Aufruf der IoUnRegisterBootDriverCallback-Routine bereitgestellt werden, die die Registrierung der BOOT_DRIVER_CALLBACK_FUNCTION-Routine aufhebt.

Hinweise

Starttreiber müssen IoUnRegisterBootDriverCallback aufrufen und das zurückgegebene Handle übergeben, um die Registrierung des Starttreiberrückrufs aufzuheben, bevor Windows sie entlädt.

Alle Fehler, die von einem status Updaterückruf zurückgegeben werden, werden als schwerwiegend behandelt und führen zu einer Systemfehlerüberprüfung. Wenn ein Initialize-Imagerückruf einen Fehler zurückgibt, wird das Image des Treibers als unbekannt behandelt. Um über Start-Start-Treiberinitialisierungsvorgänge benachrichtigt zu werden, kann ein ELAM-Treiber (Early Launch Anti-Malware ) IoRegisterBootDriverCallback aufrufen, um eine BOOT_DRIVER_CALLBACK_FUNCTION Routine zu registrieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Universell
Header	ntddk.h (include Ntddk.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Weitere Informationen

BDCB_CALLBACK_TYPE

BDCB_IMAGE_INFORMATION

IoUnRegisterBootDriverCallback