ExAcquireRundownProtectionCacheAwareEx 函式（wdm.h）

發行項
02/07/2025

ExAcquireRundownProtectionCacheAwareEx 例程會嘗試取得共享物件上的快取感知執行保護，讓呼叫端可以安全地存取物件。

語法

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

參數

[in, out] RunRefCacheAware

先前呼叫 exAllocateCacheAwareRundownProtection 或 ExInitializeRundownProtectionCacheAware所傳回之不透明 EX_RUNDOWN_REF_CACHE_AWARE 結構的指標。

[in] Count

要遞增至物件的向下執行實例計數的數量。只有當例程傳回 true 時，才會遞增計數。如需詳細資訊，請參閱。

傳回值

ExAcquireRundownProtectionCacheAwareEx 如果例程成功取得呼叫者的執行保護，則會傳回 true。否則，它會 FALSE傳回。 FALSE 的傳回值 表示對象的執行已啟動，而且對象必須視為無效。

言論

RunRefCacheAware 參數指向追蹤相關聯物件執行狀態的 EX_RUNDOWN_REF_CACHE_AWARE 結構。此狀態資訊包含目前在物件上生效的快取感知執行保護實例計數。 ExAcquireRundownProtectionCacheAwareEx 和 ExReleaseRundownProtectionCacheAwareEx 例程會依任意數量遞增和遞減此計數。兩個相關的例程，ExAcquireRundownProtectionCacheAware 和 ExReleaseRundownProtectionCacheAware，遞增和遞減此計數一個。

只要 run-down 區塊本身為非分頁，就可以在 DISPATCH_LEVEL呼叫此函式。

如需詳細資訊，請參閱快取感知執行保護。

要求

要求	價值
支援的最低伺服器	Windows Server 2003、Service Pack 1
標頭	wdm.h （包括 Wdm.h）
DDI 合規性規則	HwStorPortProhibitedDIs（storport）