ExReInitializeRundownProtectionCacheAware 函式 (wdm.h)

發行項
02/27/2024

ExReInitializeRundownProtectionCacheAware 例程會在相關聯的物件執行後重新初始化EX_RUNDOWN_REF_CACHE_AWARE結構。

語法

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

參數

[in, out] RunRefCacheAware

先前呼叫 ExAllocateCacheAwareRundownProtection 或 ExInitializeRundownProtectionCacheAware 所初始化之EX_RUNDOWN_REF_CACHE_AWARE結構的指標。快取感知執行保護例程會使用此結構來追蹤相關聯共享物件的執行狀態。此結構對驅動程式不透明。

傳回值

無

備註

此例程是由擁有位於共用記憶體中且由其他驅動程式存取之對象的驅動程式所呼叫。

ExReInitializeRundownProtectionCacheAware 可讓先前使用的 EX_RUNDOWN_REF_CACHE_AWARE 結構與新對象相關聯，並初始化這個物件的快取感知向下執行保護。 在 ExReInitializeRundownProtectionCacheAware 呼叫之後，驅動程式可以呼叫 ExAcquireRundownProtectionCacheAware，以取得新物件的快取感知向下執行保護。

ExReInitializeRundownProtectionCacheAware 呼叫之前必須呼叫執行舊物件的 ExWaitForRundownProtectionReleaseCacheAware 例程。 在 ExWaitForRundownProtectionReleaseCacheAware 和 ExReInitializeRundownProtectionCacheAware 呼叫之間，驅動程式可能會呼叫 ExRundownCompletedCacheAware 例程，以指出舊對象的執行已完成。

在專案上， EX_RUNDOWN_REF_CACHE_AWARE 結構中的狀態信息必須指出舊物件已執行。