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 |