IoRegisterBootDriverReinitialization-Funktion (ntddk.h)
Die IoRegisterBootDriverReinitialization-Routine wird von einem Starttreiber aufgerufen, um die Neuitialisierungsroutine des Treibers beim E/A-Manager zu registrieren, der aufgerufen werden soll, nachdem alle Geräte aufgelistet und gestartet wurden.
Syntax
void IoRegisterBootDriverReinitialization(
[in] PDRIVER_OBJECT DriverObject,
[in] PDRIVER_REINITIALIZE DriverReinitializationRoutine,
[in, optional] PVOID Context
);
Parameter
[in] DriverObject
Zeiger auf das Treiberobjekt, damit der Starttreiber neu initialisiert wird.
[in] DriverReinitializationRoutine
Zeiger auf die Routine zum Erneut initialisieren des Treibers.
[in, optional] Context
Optionaler Kontextzeiger, der an die Reitialisierungsroutine des Treibers übergeben werden soll.
Rückgabewert
Keine
Bemerkungen
Ein Starttreiber ruft normalerweise IoRegisterBootDriverReinitialization aus seiner DriverEntry-Routine auf, die während der Starttreiberinitialisierung ausgeführt wird. IoRegisterBootDriverReinitialization registriert die Rückrufroutine des Treibers für die Neuitialisierung, die vom E/A-Manager aufgerufen wird, nachdem alle Geräte aufgelistet und gestartet wurden. DriverReinitializationRoutine wird in einem Systemthread unter IRQL = PASSIVE_LEVEL ausgeführt.
Ein Treiber sollte IoRegisterBootDriverReinitialization nur aufrufen, wenn seine DriverEntry-Routine STATUS_SUCCESS zurückgibt.
Wenn DriverReinitializationRoutine die Registrierung verwendet, muss die DriverEntry-Routine im Context-Parameter von IoRegisterBootDriverReinitialization eine Kopie der Zeichenfolge enthalten, auf die der eigene RegistryPath-Parameter von DriverEntry verweist.
Die DriverEntry-Routine kann IoRegisterBootDriverReinitialization nur einmal aufrufen. Wenn die Reitialisierungsroutine mehr als einmal ausgeführt werden muss, kann DriverReinitializationRoutineIoRegisterBootDriverReinitialization so viele zusätzliche Male wie erforderlich aufrufen, indem der Count-Parameter verwendet wird, um die Anzahl der Aufrufe von DriverReinitializationRoutine nachzuverfolgen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar ab Windows 2000. |
Zielplattform | Universell |
Header | ntddk.h (include Ntifs.h, Ntddk.h, Ntifs.h) |
Bibliothek | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |