ExInitializeRundownProtection-Funktion (wdm.h)

Die ExInitializeRundownProtection-Routine initialisiert den Rundown-Schutz für ein freigegebenes Objekt.

Syntax

void ExInitializeRundownProtection(
  [out] PEX_RUNDOWN_REF RunRef
);

Parameter

[out] RunRef

Ein Zeiger auf eine vom Aufrufer zugeordnete EX_RUNDOWN_REF Struktur, die initialisiert werden soll. Die Zuordnung muss 4 Byte auf 32-Bit-Plattformen ausgerichtet und 8 Byte auf 64-Bit-Plattformen ausgerichtet sein. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Keine

Bemerkungen

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

ExInitializeRundownProtection muss aufgerufen werden, um eine EX_RUNDOWN_REF-Struktur zu initialisieren, bevor sie als Parameter an eine andere Herunterlaufschutzroutine übergeben wird.

Die Rundownschutzroutinen verwenden die EX_RUNDOWN_REF-Struktur, um die ausgeführte status eines freigegebenen Objekts zu verfolgen, das der Struktur zugeordnet ist. Diese status Informationen umfassen die Anzahl der Instanzen des Rundown-Schutzes, die derzeit für das Objekt wirksam sind. ExInitializeRundownProtection initialisiert diese Anzahl auf Null.

Nachdem eine EX_RUNDOWN_REF-Struktur initialisiert wurde, können andere Treiber, die auf das zugeordnete Objekt zugreifen, die Routinen ExAcquireRundownProtection und ExReleaseRundownProtection aufrufen, um run-down-Schutz für das Objekt abzurufen und freizugeben.

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 (wdm.h einschließen)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Weitere Informationen

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExReleaseRundownProtection