Función IoRegisterBootDriverReinitialization (ntddk.h)
Un controlador de arranque llama a la rutina IoRegisterBootDriverReinitialization para registrar la rutina de reinicialización del controlador con el administrador de E/S que se llamará después de que se hayan enumerado e iniciado todos los dispositivos.
Sintaxis
void IoRegisterBootDriverReinitialization(
[in] PDRIVER_OBJECT DriverObject,
[in] PDRIVER_REINITIALIZE DriverReinitializationRoutine,
[in, optional] PVOID Context
);
Parámetros
[in] DriverObject
Puntero al objeto de controlador para que se reinicialice el controlador de arranque.
[in] DriverReinitializationRoutine
Puntero a la rutina reinicializar del controlador.
[in, optional] Context
Puntero de contexto opcional que se pasará a la rutina de reinicialización del controlador.
Valor devuelto
Ninguno
Observaciones
Normalmente, un controlador de arranque llama a ioRegisterBootDriverReinitialization desde su rutina de DriverEntry, que se ejecuta durante la inicialización del controlador de arranque. IoRegisterBootDriverReinitialization registra la rutina de devolución de llamada de reinicialización del controlador a la que llamará el administrador de E/S una vez enumerados e iniciados todos los dispositivos. El driverReinitializationRoutine de se ejecuta en un subproceso del sistema en IRQL = PASSIVE_LEVEL.
Un controlador debe llamar a ioRegisterBootDriverReinitialization solo si su rutina de DriverEntry devolverá STATUS_SUCCESS.
Si el DriverReinitializationRoutine de usa el registro, la rutina de DriverEntry debe incluirse en IoRegisterBootDriverReinitializationel parámetro Context de parámetro a la que DriverEntry"s own RegistryPath puntos de parámetro.
La rutina de driverEntry de puede llamar a IoRegisterBootDriverReinitialization solo una vez. Si la rutina de reinicialización debe ejecutarse más de una vez, el DriverReinitializationRoutine puede llamar a IoRegisterBootDriverReinitialization tantas veces adicionales como sea necesario, con el parámetro Count para realizar un seguimiento del número de veces que se ha llamado al DriverReinitializationRoutine.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 2000. |
| de la plataforma de destino de | Universal |
| encabezado de | ntddk.h (incluya Ntifs.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |