IoRegisterBootDriverReinitialization-Funktion (ntddk.h)

Die IoRegisterBootDriverReinitialization-Routine wird von einem Starttreiber aufgerufen, um die Reinitialisierungsroutine des Treibers mit dem I/O-Manager zu registrieren, der aufgerufen werden soll, nachdem alle Geräte aufgezählt 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 für den Starttreiber, um wiederitialisiert zu werden.

[in] DriverReinitializationRoutine

Zeiger auf die Reinitialisierungsroutine des Treibers.

[in, optional] Context

Optionaler Kontextzeiger, der an die Reinitialisierungsroutine des Treibers übergeben werden soll.

Rückgabewert

Keine

Bemerkungen

Ein Starttreiber ruft in der Regel IoRegisterBootDriverReinitialization aus seiner DriverEntry-Routine auf, die während der Starttreiber-Initialisierung ausgeführt wird. IoRegisterBootDriverReinitialization registriert die Wiederanrufroutine des Treibers, die vom I/O-Manager aufgerufen werden soll, nachdem alle Geräte aufgezählt und gestartet wurden. Die DriverReinitializationRoutine wird in einem Systemthread bei IRQL = PASSIVE_LEVEL ausgeführt.

Ein Treiber sollte IoRegisterBootDriverReinitialization nur aufrufen, wenn seine DriverEntry-Routine STATUS_SUCCESS zurückzugeben.

Wenn die DriverReinitializationRoutine die Registrierung verwendet, muss die DriverEntry-Routine im Kontextparameter der 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 Reinitialisierungsroutine mehr als einmal ausgeführt werden muss, kann die DriverReinitializationRoutine die IoRegisterBootDriverReinitialization so viele weitere Zeiten wie erforderlich aufrufen, indem Sie den Parameter Count verwenden, um die Anzahl der Aufrufe der DriverReinitializationRoutine zu verfolgen.

Anforderungen

   
Unterstützte Mindestversion (Client) Verfügbar ab Windows 2000.
Zielplattform Universell
Header ntddk.h (enthalten Ntifs.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Siehe auch

DRIVER_OBJECT

IoRegisterDriverReinitialisierung

Initialisieren