ExAcquireRundownProtectionEx-Funktion (wdm.h)

Artikel
03/01/2024

Die ExAcquireRundownProtectionEx-Routine versucht, run-down-Schutz für ein freigegebenes Objekt zu erhalten, damit der Aufrufer sicher auf das Objekt zugreifen kann.

Syntax

BOOLEAN ExAcquireRundownProtectionEx(
  [in, out] PEX_RUNDOWN_REF RunRef,
  [in]      ULONG           Count
);

Parameter

[in, out] RunRef

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

[in] Count

Der Betrag, um den der Rundown instance Anzahl des Objekts erhöht werden soll. Die Anzahl wird nur erhöht, wenn die Routine TRUE zurückgibt. Weitere Informationen finden Sie unter Hinweise.

Rückgabewert

ExAcquireRundownProtectionEx gibt TRUE zurück, wenn die Routine erfolgreich einen Rundownschutz für den Aufrufer erhält. Andernfalls wird FALSE zurückgegeben. Der Rückgabewert FALSE gibt an, dass die Ausführung des Objekts gestartet wurde und dass das Objekt als ungültig behandelt werden muss.

Hinweise

Um sicher auf ein freigegebenes Objekt zuzugreifen, ruft ein Treiber ExAcquireRundownProtectionEx auf, um run-down-Schutz für das Objekt zu erhalten.

Der RunRef-Parameter verweist auf eine EX_RUNDOWN_REF-Struktur, die die ausgeführte status des zugeordneten Objekts nachverfolgt. Diese status Informationen umfassen die Anzahl der Instanzen des Rundown-Schutzes, die derzeit für das Objekt wirksam sind. Die Routinen ExAcquireRundownProtectionEx und ExReleaseRundownProtectionEx erhöhen und verringern diese Anzahl um beliebige Mengen. Zwei verwandte Routinen, ExAcquireRundownProtection und ExReleaseRundownProtection, erhöhen und verringern diese Anzahl um eins.

Solange der run-down-Block selbst nicht aus der Seite ist, kann diese Funktion bei DISPATCH_LEVEL aufgerufen werden.

Weitere Informationen finden Sie unter Run-Down Protection.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows Server 2003.
Zielplattform	Universell
Header	wdm.h (wdm.h einschließen)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (siehe Hinweise)
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport)