Valori restituiti driverEntry

Una routine DriverEntry restituisce un valore NTSTATUS, STATUS_SUCCESS o uno stato di errore appropriato.

La routine DriverEntry deve posticipare qualsiasi chiamata a IoRegisterDriverReinitialization fino a quando non viene restituita STATUS_SUCCESS. Non deve effettuare questa chiamata a meno che non restituisca STATUS_SUCCESS.

Se una routine DriverEntry restituisce un valore NTSTATUS che non è un valore informativo o positivo, ad esempio STATUS_SUCCESS, il driver per tale routine DriverEntry non viene caricato.

Una routine DriverEntry che non riuscirà l'inizializzazione deve liberare tutti gli oggetti di sistema, le risorse di sistema e le risorse del Registro di sistema già configurate prima che restituisca il controllo. Deve reimpostare i punti di ingresso dispatch del driver nell'oggetto driver per IRP_MJ_FLUSH_BUFFERS e IRP_MJ_SHUTDOWN su NULL se il driver supporta queste richieste.

Se l'inizializzazione di un driver avrà esito negativo, anche la routine DriverEntry dovrebbe registrare un errore prima di restituire il controllo. Vedere Registrazione degli errori.

Si noti che la routine Unload di un driver non viene chiamata se la routine DriverEntry di un driver restituisce uno stato di errore.