Funzione ExAcquireRundownProtectionCacheAwareEx (wdm.h)

Articolo
03/05/2024

La routine ExAcquireRundownProtectionCacheAwareEx tenta di acquisire la protezione run-down compatibile con la cache in un oggetto condiviso in modo che il chiamante possa accedere in modo sicuro all'oggetto.

Sintassi

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

Parametri

[in, out] RunRefCacheAware

Puntatore alla struttura EX_RUNDOWN_REF_CACHE_AWARE opaca restituita da una chiamata precedente a ExAllocateCacheAwareRundownProtection o ExInitializeRundownProtectionCacheAware.

[in] Count

Quantità in base alla quale incrementare il numero di istanze di run-down dell'oggetto. Il conteggio viene incrementato solo se la routine restituisce TRUE. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

ExAcquireRundownProtectionCacheAwareEx restituisce TRUE se la routine acquisisce correttamente la protezione di run-down per il chiamante. In caso contrario, restituisce FALSE. Un valore restituito FALSE indica che l'esecuzione dell'oggetto è stata avviata e che l'oggetto deve essere considerato non valido.

Commenti

Il parametro RunRefCacheAware punta a una struttura EX_RUNDOWN_REF_CACHE_AWARE che tiene traccia dello stato di esecuzione dell'oggetto associato. Queste informazioni sullo stato includono un conteggio delle istanze della protezione di run-down compatibile con la cache attualmente in vigore sull'oggetto. Le routine ExAcquireRundownProtectionCacheAwareEx e ExReleaseRundownProtectionCacheAwareEx incrementa e decrementa questo conteggio in base a quantità arbitrarie. Due routine correlate, ExAcquireRundownProtectionCacheAware e ExReleaseRundownProtectionCacheAware, incrementa e decrementa questo conteggio di uno.

Se il blocco di esecuzione stesso non viene eseguito in pagine, questa funzione può essere chiamata in DISPATCH_LEVEL.

Per altre informazioni, vedere Protezione di run-down compatibile con la cache.

Requisiti

Requisito	Valore
Server minimo supportato	Windows Server 2003, Service Pack 1
Intestazione	wdm.h (include Wdm.h)
Regole di conformità DDI	HwStorPortProhibitedDDIs(storport)