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 结构中的状态信息必须指示与此结构关联的对象已运行。