ExAcquireRundownProtectionCacheAwareEx-Funktion (wdm.h)

Artikel
03/05/2024

Die ExAcquireRundownProtectionCacheAwareEx-Routine versucht, einen cachefähigen Rundownschutz für ein freigegebenes Objekt abzurufen, damit der Aufrufer sicher auf das Objekt zugreifen kann.

Syntax

BOOLEAN ExAcquireRundownProtectionCacheAwareEx(
  [in, out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware,
  [in]      ULONG                       Count
);

Parameter

[in, out] RunRefCacheAware

Zeiger auf die nicht transparente EX_RUNDOWN_REF_CACHE_AWARE Struktur, die von einem vorherigen Aufruf von ExAllocateCacheAwareRundownProtection oder ExInitializeRundownProtectionCacheAware zurückgegeben wurde.

[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 in den Hinweisen.

Rückgabewert

ExAcquireRundownProtectionCacheAwareEx 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

Der Parameter RunRefCacheAware verweist auf eine EX_RUNDOWN_REF_CACHE_AWARE-Struktur, die die ausgeführte status des zugeordneten Objekts nachverfolgt. Diese status Informationen umfassen die Anzahl von Instanzen des cachefähigen Rundown-Schutzes, die derzeit für das Objekt wirksam sind. Die Routinen ExAcquireRundownProtectionCacheAwareEx und ExReleaseRundownProtectionCacheAwareEx erhöhen und verringern diese Anzahl um beliebige Mengen. Zwei verwandte Routinen, ExAcquireRundownProtectionCacheAware und ExReleaseRundownProtectionCacheAware, 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 Cache-fähiger Rundownschutz.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Server)	Windows Server 2003, Service Pack 1
Kopfzeile	wdm.h (wdm.h einschließen)
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport)