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)

Weitere Informationen

DRIVER_OBJECT

IoRegisterDriverReinitialisierung

Initialisieren