Fonction IoRegisterBootDriverCallback (ntddk.h)
La routine IoRegisterBootDriverCallback inscrit une routine BOOT_DRIVER_CALLBACK_FUNCTION à appeler lors de l’initialisation d’un pilote de démarrage et de ses DLL dépendantes.
Syntaxe
PVOID IoRegisterBootDriverCallback(
[in] PBOOT_DRIVER_CALLBACK_FUNCTION CallbackFunction,
[in, optional] PVOID CallbackContext
);
Paramètres
[in] CallbackFunction
Pointeur vers la routine BOOT_DRIVER_CALLBACK_FUNCTION à appeler lors de l’initialisation d’un pilote de démarrage ou d’une DLL.
[in, optional] CallbackContext
Contexte défini par le pilote à passer à la routine BOOT_DRIVER_CALLBACK_FUNCTION pointée par CallbackFunction.
Valeur de retour
Handle qui représente l’inscription. Ce handle doit être fourni en tant que paramètre d’entrée dans l’appel à la routine IoUnRegisterBootDriverCallback qui annule l’inscription de la routine BOOT_DRIVER_CALLBACK_FUNCTION.
Remarques
Les pilotes de démarrage doivent appeler IoUnRegisterBootDriverCallback et passer le handle retourné pour désinscrire le rappel du pilote de démarrage avant de les décharger.
Toute erreur retournée à partir d’un rappel de mise à jour d’état est traitée comme irrécupérable et entraîne une vérification des bogues système. En outre, si un rappel d’image initialisé retourne une erreur, l’image du pilote est traitée comme inconnue. Pour être averti des opérations d’initialisation du pilote de démarrage, un pilote lancement anticipé (ELAM) peut appeler IoRegisterBootDriverCallback pour inscrire une routine de BOOT_DRIVER_CALLBACK_FUNCTION.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8. |
| plateforme cible | Universel |
| d’en-tête | ntddk.h (include Ntddk.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |