ExReInitializeRundownProtection-Funktion (wdm.h)

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

Weitere Informationen

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExInitializeRundownProtection

ExRundownCompleted

ExWaitForRundownProtectionRelease