ExRundownCompletedCacheAware-Funktion (wdm.h)

Artikel
02/27/2024

Die ExRundownCompletedCacheAware-Routine aktualisiert die heruntergefahrene status 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

Zeiger auf das Rundownschutzobjekt, für das 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 ExInitializeRundownProtectionCacheAware zurückgegeben wurde.

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. Dem ExRundownCompletedCacheAware-Aufruf muss ein Aufruf der ExWaitForRundownProtectionReleaseCacheAware-Routine vorangestellt sein, die das Objekt herunterläuft.

Nach einem ExRundownCompletedCacheAware-Aufruf werden zusätzliche Aufrufe von ExWaitForRundownProtectionReleaseCacheAware zum Ausführen des zugeordneten Objekts sofort ohne Wartezeit zurückgegeben. Aufrufe von ExAcquireRundownProtectionCacheAware zum Abrufen des Rundownschutzes für das zugeordnete Objekt schlagen jedoch fehl ( ZURÜCKGEBEN VON FALSE).

Nach einem ExRundownCompletedCacheAware-Aufruf kann der Treiber die ExReInitializeRundownProtectionCacheAware-Routine aufrufen, um die EX_RUNDOWN_REF_CACHE_AWARE-Struktur einem neuen Objekt zuzuordnen und den Rundownschutz für dieses Objekt zu initialisieren. Nach dem ExReInitializeRundownProtection-Aufruf können Treiber ExAcquireRundownProtectionCacheAware aufrufen, um den Rundownschutz für das neue Objekt zu erhalten.

Beim Eintrag muss die status Informationen in der EX_RUNDOWN_REF_CACHE_AWARE-Struktur angeben, dass das dieser Struktur zugeordnete Objekt heruntergefahren wurde.