ExAcquireRundownProtectionCacheAwareEx 函式 (wdm.h)
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,遞增並遞減此計數。
只要執行區塊本身為非分頁,就可以在DISPATCH_LEVEL呼叫此函式。
如需詳細資訊,請參閱 快取感知執行保護。
規格需求
需求 | 值 |
---|---|
最低支援的伺服器 | Windows Server 2003 Service Pack 1 |
標頭 | wdm.h (包含 Wdm.h) |
DDI 合規性規則 | HwStorPortProhibitedDIS (storport) |
另請參閱
ExAcquireRundownProtectionCacheAware
ExAllocateCacheAwareRundownProtection
ExFreeCacheAwareRundownProtection
ExInitializeRundownProtectionCacheAware
ExReInitializeRundownProtectionCacheAware
ExReleaseRundownProtectionCacheAware
ExReleaseRundownProtectionCacheAwareEx