Valores retornados de DriverEntry

Uma rotina DriverEntry retorna um valor NTSTATUS, STATUS_SUCCESS ou um erro apropriado status.

A rotina DriverEntry deve adiar qualquer chamada para IoRegisterDriverReinitialization até pouco antes de retornar STATUS_SUCCESS. Ele não deve fazer essa chamada, a menos que retorne STATUS_SUCCESS.

Se uma rotina DriverEntry retornar um valor NTSTATUS que não seja um valor informativo ou de êxito, como STATUS_SUCCESS, o driver dessa rotina DriverEntry não será carregado.

Uma rotina driverEntry que falhará na inicialização deve liberar todos os objetos do sistema, recursos do sistema e recursos do Registro que ele já configurou antes de retornar o controle. Ele deve redefinir os pontos de entrada de expedição do driver no objeto driver para IRP_MJ_FLUSH_BUFFERS e IRP_MJ_SHUTDOWN para NULL se o driver der suporte a essas solicitações.

Se um driver falhar na inicialização, a rotina DriverEntry também deverá registrar um erro antes de retornar o controle. Consulte Erros de registro em log.

Observe que a rotina de descarregamento de um driver não será chamada se a rotina DriverEntry de um driver retornar uma falha status.