Funzione IoRegisterBootDriverReinitialization (ntddk.h)

  • Articolo

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)

Vedi anche

DRIVER_OBJECT

IoRegisterDriverReinitialization

Reinizializzare