ExRundownCompletedCacheAware 函式 (wdm.h)

發行項
02/27/2024

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

語法

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

參數

[in, out] RunRefCacheAware

函式將運作的下一個保護物件的指標。這是先前呼叫 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 結構中的狀態信息必須指出與此結構相關聯的物件已執行。