Funzione IoRegisterBootDriverReinitialization (ntddk.h)
La routine IoRegisterBootDriverReinitialization viene chiamata da un driver di avvio per registrare la routine di reinizializzazione del driver con la gestione I/O da chiamare dopo l'enumerazione e l'avvio di tutti i dispositivi.
Sintassi
void IoRegisterBootDriverReinitialization(
[in] PDRIVER_OBJECT DriverObject,
[in] PDRIVER_REINITIALIZE DriverReinitializationRoutine,
[in, optional] PVOID Context
);
Parametri
[in] DriverObject
Puntatore all'oggetto driver per il driver di avvio da reinizializzare.
[in] DriverReinitializationRoutine
Puntatore alla routine Reinitialize del driver.
[in, optional] Context
Puntatore di contesto facoltativo da passare alla routine di reinizializzazione del driver.
Valore restituito
nessuno
Osservazioni
Un driver di avvio chiama normalmente IoRegisterBootDriverReinitialization dalla routine DriverEntry , che viene eseguita durante l'inizializzazione del driver di avvio. IoRegisterBootDriverReinitialization registra la routine di callback di reinizializzazione del driver da chiamare dalla gestione I/O dopo l'enumerazione e l'avvio di tutti i dispositivi. DriverReinitializationRoutine viene eseguito in un thread di sistema in IRQL = PASSIVE_LEVEL.
Un driver deve chiamare IoRegisterBootDriverReinitialization solo se la routine DriverEntry restituirà STATUS_SUCCESS.
Se DriverReinitializationRoutine usa il Registro di sistema, la routine DriverEntry deve includere nel parametro Context di IoRegisterBootDriverReinitialization una copia della stringa a cui punta il parametro RegistryPath di DriverEntry.
La routine DriverEntry può chiamare IoRegisterBootDriverReinitialization una sola volta. Se la routine di reinizializzazione deve essere eseguita più volte, driverReinitializationRoutine può chiamare IoRegisterBootDriverReinitialization quante più volte necessario, usando il parametro Count per tenere traccia del numero di volte in cui è stato chiamato DriverReinitializationRoutine .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | ntddk.h (include Ntifs.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |