ExReInitializeRundownProtection-Funktion (wdm.h)

Artikel
02/27/2024

Die ExReInitializeRundownProtection-Routine initialisiert eine EX_RUNDOWN_REF-Struktur neu, nachdem das zugeordnete Objekt heruntergefahren wurde.

Syntax

void ExReInitializeRundownProtection(
  [in, out] PEX_RUNDOWN_REF RunRef
);

Parameter

[in, out] RunRef

Ein Zeiger auf eine EX_RUNDOWN_REF Struktur, die durch einen vorherigen Aufruf der ExInitializeRundownProtection-Routine initialisiert wurde. Die heruntergefahrenen Schutzroutinen verwenden diese Struktur, um den heruntergefahrenen status des zugeordneten freigegebenen Objekts nachzuverfolgen. Diese Struktur ist für Treiber undurchsichtig.

Rückgabewert

Keine

Bemerkungen

Diese Routine wird vom Treiber aufgerufen, der ein Objekt besitzt, das sich im freigegebenen Arbeitsspeicher befindet und auf das andere Treiber zugreifen.

ExReInitializeRundownProtection ermöglicht es einer zuvor verwendeten EX_RUNDOWN_REF-Struktur , einem neuen Objekt zuzuordnen, und initialisiert den Rundownschutz für dieses Objekt. Nach dem ExReInitializeRundownProtection-Aufruf können Treiber ExAcquireRundownProtection aufrufen, um den Rundownschutz für das neue Objekt zu erhalten.

Einem ExReInitializeRundownProtection-Aufruf muss ein Aufruf der ExWaitForRundownProtectionRelease-Routine vorangestellt sein, die das alte Objekt herunterläuft. Zwischen den Aufrufen ExWaitForRundownProtectionRelease und ExReInitializeRundownProtection ruft der Treiber möglicherweise die ExRundownCompleted-Routine auf, um anzugeben, dass die Ausführung des alten Objekts abgeschlossen ist.

Beim Eintrag muss die status Informationen in der EX_RUNDOWN_REF-Struktur angeben, dass das alte Objekt heruntergefahren wurde.

Weitere Informationen finden Sie unter Run-Down Protection.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows XP.
Zielplattform	Universell
Header	wdm.h (einschließen von Wdm.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL