Valeurs de retour driverEntry

Une routine DriverEntry retourne une valeur NTSTATUS, STATUS_SUCCESS ou une status d’erreur appropriée.

La routine DriverEntry doit reporter tout appel à IoRegisterDriverReinitialization jusqu’à ce qu’il ne retourne STATUS_SUCCESS. Il ne doit pas effectuer cet appel, sauf s’il retourne STATUS_SUCCESS.

Si une routine DriverEntry retourne une valeur NTSTATUS qui n’est pas une valeur de réussite ou d’information, telle que STATUS_SUCCESS, le pilote de cette routine DriverEntry n’est pas chargé.

Une routine DriverEntry qui échouera l’initialisation doit libérer tous les objets système, les ressources système et les ressources de Registre qu’elle a déjà configurées avant qu’elle ne retourne le contrôle. Il doit réinitialiser les points d’entrée de répartition du pilote dans l’objet driver pour IRP_MJ_FLUSH_BUFFERS et IRP_MJ_SHUTDOWN la valeur NULL si le pilote prend en charge ces requêtes.

Si un pilote échoue à l’initialisation, la routine DriverEntry doit également consigner une erreur avant de retourner le contrôle. Consultez Erreurs de journalisation.

Notez que la routine de déchargement d’un pilote n’est pas appelée si la routine DriverEntry d’un pilote retourne une status d’échec.