Funzione ExRundownCompletedCacheAware (wdm.h)

Articolo
02/07/2025

La routine ExRundownCompletedCacheAware aggiorna lo stato di esecuzione di un oggetto condiviso per indicare che l'esecuzione dell'oggetto è stata completata.

Sintassi

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

Parametri

[in, out] RunRefCacheAware

Puntatore all'oggetto protezione rundown su cui funzionerà la funzione. Si tratta di un puntatore a una struttura EX_RUNDOWN_REF_CACHE_AWARE opaca restituita da una chiamata precedente a ExAllocateCacheAwareRundownProtection o ExInitializeRundownProtectionCacheAware.

Valore restituito

Nessuno

Osservazioni

Questa routine viene chiamata dal driver proprietario di un oggetto che risiede nella memoria condivisa e accessibile da altri driver. La chiamata ExRundownCompletedCacheAware deve essere preceduta da una chiamata al ExWaitForRundownProtectionReleaseCacheAware routine che esegue l'oggetto.

Dopo una chiamata ExRundownCompletedCacheAware, chiamate aggiuntive a ExWaitForRundownProtectionReleaseCacheAware per eseguire immediatamente l'oggetto associato senza attendere. Tuttavia, le chiamate a ExAcquireRundownProtectionCacheAware per acquisire la protezione di run-down sull'oggetto associato hanno esito negativo (restituire FALSE).

Dopo una chiamata ExRundownCompletedCacheAware, il driver può chiamare il ExReInitializeRundownProtectionCacheAware routine per associare la struttura EX_RUNDOWN_REF_CACHE_AWARE a un nuovo oggetto e per inizializzare la protezione di run-down in questo oggetto. Dopo la chiamata exReInitializeRundownProtection, i driver possono chiamare ExAcquireRundownProtectionCacheAware per acquisire la protezione di run-down sul nuovo oggetto.

In caso di immissione, le informazioni sullo stato nella struttura EX_RUNDOWN_REF_CACHE_AWARE devono indicare che l'oggetto associato a questa struttura è stato eseguito inattivo.