Funzione ExAcquireRundownProtectionCacheAwareEx (wdm.h)

Articolo
07/02/2025

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

Sintassi

C++

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

Parametri

[in, out] RunRefCacheAware

Puntatore alla struttura di 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 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 di FALSE indica che l'esecuzione dell'oggetto è stata avviata e che l'oggetto deve essere considerato non valido.

Osservazioni

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. Il ExAcquireRundownProtectionCacheAwareEx e ExReleaseRundownProtectionCacheAwareEx incrementa e decrementa questo conteggio in base a importi arbitrari. Due routine correlate, ExAcquireRundownProtectionCacheAware e ExReleaseRundownProtectionCacheAware, incrementa e decrementa questo conteggio di uno.

Purché il blocco di run-down stesso non sia di pagina, questa funzione può essere chiamata in DISPATCH_LEVEL.

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

Fabbisogno

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