Função IoRegisterBootDriverReinitialization (ntddk.h)

A rotina de IoRegisterBootDriverReinitialization é chamada por um driver de inicialização para registrar a rotina de reinicialização do driver com o gerente de E/S a ser chamado depois que todos os dispositivos tiverem sido enumerados e iniciados.

Sintaxe

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

Parâmetros

[in] DriverObject

Ponteiro para o objeto driver para que o driver de inicialização seja reinicializado.

[in] DriverReinitializationRoutine

Ponteiro para a rotina de Reinicializar do driver.

[in, optional] Context

Ponteiro de contexto opcional a ser passado para a rotina de reinicialização do driver.

Valor de retorno

Nenhum

Observações

Um driver de inicialização normalmente chama IoRegisterBootDriverReinitialization de sua rotina de DriverEntry, que é executada durante a inicialização do driver de inicialização. IoRegisterBootDriverReinitialization registra a rotina de retorno de chamada de reinicialização do driver a ser chamada pelo gerente de E/S depois que todos os dispositivos tiverem sido enumerados e iniciados. O DriverReinitializationRoutine é executado em um thread do sistema em IRQL = PASSIVE_LEVEL.

Um driver deve chamar IoRegisterBootDriverReinitialization somente se sua rotina de driverEntry retornar STATUS_SUCCESS.

Se o DriverReinitializationRoutine usar o registro, a rotina de DriverEntry deverá incluir no parâmetro IoRegisterBootDriverReinitializationContext uma cópia da cadeia de caracteres à qual DriverEntry's own RegistryPath parâmetro.

A rotina DriverEntry pode chamar IoRegisterBootDriverReinitialization apenas uma vez. Se a rotina de reinicialização precisar ser executada mais de uma vez, o DriverReinitializationRoutine poderá chamar IoRegisterBootDriverReinitialization quantas vezes mais forem necessárias, usando o parâmetro Count para acompanhar o número de vezes que o driverReinitializationRoutine foi chamado.

Requisitos

Consulte também

DRIVER_OBJECT

IoRegisterDriverReinitialization

reinicializar