ExRundownCompletedCacheAware-Funktion (wdm.h)

Artikel
02/07/2025

Die ExRundownCompletedCacheAware Routine aktualisiert den Ausführungsstatus eines freigegebenen Objekts, um anzugeben, dass die Ausführung des Objekts abgeschlossen ist.

Syntax

void ExRundownCompletedCacheAware(
  [in, out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
);

Parameter

[in, out] RunRefCacheAware

Zeigen Sie auf das Rundown-Schutzobjekt, auf dem die Funktion ausgeführt wird. Dies ist ein Zeiger auf eine undurchsichtige EX_RUNDOWN_REF_CACHE_AWARE Struktur, die von einem vorherigen Aufruf von ExAllocateCacheAwareRundownProtection oder ExInitializeRundownProtectionCacheAwarezurückgegeben wird.

Rückgabewert

Nichts

Bemerkungen

Diese Routine wird vom Treiber aufgerufen, der ein Objekt besitzt, das sich im freigegebenen Speicher befindet und von anderen Treibern aufgerufen wird. Dem ExRundownCompletedCacheAware- Aufruf muss ein Aufruf der ExWaitForRundownProtectionReleaseCacheAware Routine vorangestellt werden, die das Objekt ausführt.

Nachdem ein ExRundownCompletedCacheAware-aufruft, zusätzliche Aufrufe an ExWaitForRundownProtectionReleaseCacheAware, um die Rückgabe des zugeordneten Objekts sofort auszuführen, ohne zu warten. Aufrufe von ExAcquireRundownProtectionCacheAware jedoch zum Abrufen des Abwärtsschutzes für das zugeordnete Objekt fehl (zurückgeben FALSE).

Nachdem ein ExRundownCompletedCacheAware- Aufruf aufgerufen wurde, kann der Treiber den ExReInitializeRundownProtectionCacheAware Routine aufrufen, um die EX_RUNDOWN_REF_CACHE_AWARE Struktur einem neuen Objekt zuzuordnen und den Rundownschutz für dieses Objekt zu initialisieren. Nachdem der ExReInitializeRundownProtection Aufruf aufgerufen wurde, können Treiber ExAcquireRundownProtectionCacheAware- aufrufen, um run-down-Schutz für das neue Objekt abzurufen.

Bei der Eingabe müssen die Statusinformationen in der EX_RUNDOWN_REF_CACHE_AWARE-Struktur angeben, dass das Objekt, das dieser Struktur zugeordnet war, ausgeführt wurde.