Fonction IoRegisterBootDriverReinitialization (ntddk.h)

La routine IoRegisterBootDriverReinitialization est appelée par un pilote de démarrage pour inscrire la routine de réinitialisation du pilote auprès du gestionnaire d’E/S à appeler une fois que tous les appareils ont été énumérés et démarrés.

Syntaxe

void IoRegisterBootDriverReinitialization(
  [in]           PDRIVER_OBJECT       DriverObject,
  [in]           PDRIVER_REINITIALIZE DriverReinitializationRoutine,
  [in, optional] PVOID                Context
);

Paramètres

[in] DriverObject

Pointeur vers l’objet de pilote pour que le pilote de démarrage soit réinitialisé.

[in] DriverReinitializationRoutine

Pointeur vers la routine De réinitialisation du pilote.

[in, optional] Context

Pointeur de contexte facultatif à passer à la routine de réinitialisation du pilote.

Valeur de retour

None

Remarques

Un pilote de démarrage appelle normalement IoRegisterBootDriverReinitialization à partir de sa routine DriverEntry , qui est exécutée lors de l’initialisation du pilote de démarrage. IoRegisterBootDriverReinitialization inscrit la routine de rappel de réinitialisation du pilote à appeler par le gestionnaire d’E/S une fois que tous les appareils ont été énumérés et démarrés. DriverReinitializationRoutine est exécuté dans un thread système à IRQL = PASSIVE_LEVEL.

Un pilote doit appeler IoRegisterBootDriverReinitialization uniquement si sa routine DriverEntry retourne STATUS_SUCCESS.

Si DriverReinitializationRoutine utilise le registre, la routine DriverEntry doit inclure dans le paramètre Context de IoRegisterBootDriverReinitialization une copie de la chaîne vers laquelle pointe les propres paramètres RegistryPath de DriverEntry.

La routine DriverEntry peut appeler IoRegisterBootDriverReinitialization une seule fois. Si la routine de réinitialisation doit être exécutée plusieurs fois, driverReinitializationRoutine peut appeler IoRegisterBootDriverReinitialization autant de fois que nécessaire, en utilisant le paramètre Count pour effectuer le suivi du nombre de fois où DriverReinitializationRoutine a été appelé.

Configuration requise

   
Client minimal pris en charge Disponible à partir de Windows 2000.
Plateforme cible Universal
En-tête ntddk.h (include Ntifs.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Voir aussi

DRIVER_OBJECT

IoRegisterDriverReinitialization

Réinitialiser