ExRundownCompletedCacheAware 函式（wdm.h）

發行項
02/07/2025

ExRundownCompletedCacheAware 例程會更新共用物件的執行狀態，以指出對象的執行已完成。

語法

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

參數

[in, out] RunRefCacheAware

函式將運作之 Rundown 保護物件的指標。這是先前呼叫 exAllocateCacheAwareRundownProtection 或 ExInitializeRundownProtectionCacheAware所傳回之不透明 EX_RUNDOWN_REF_CACHE_AWARE 結構的指標。

傳回值

沒有

言論

此例程是由擁有位於共用記憶體中且由其他驅動程式存取之對象的驅動程式所呼叫。 ExRundownCompletedCacheAware 呼叫之前，必須先呼叫執行物件的 ExWaitForRundownProtectionReleaseCacheAware 例程。

ExRundownCompletedCacheAware 呼叫之後，ExWaitForRundownProtectionReleaseCacheAware 立即執行相關聯的對象傳回，而不需等候。不過，呼叫 ExAcquireRundownProtectionCacheAware 以取得相關聯物件上的執行保護失敗（傳回 FALSE）。

ExRundownCompletedCacheAware 呼叫之後，驅動程式可以呼叫 ExReInitializeRundownProtectionCacheAware 例程，將 EX_RUNDOWN_REF_CACHE_AWARE 結構與新的對象產生關聯，並初始化此對象的執行保護。 ExReInitializeRundownProtection 呼叫之後，驅動程式可以呼叫 ExAcquireRundownProtectionCacheAware，以取得新對象的執行保護。

在專案上，EX_RUNDOWN_REF_CACHE_AWARE 結構中的狀態信息必須指出與這個結構相關聯的物件已執行。