ExRundownCompletedCacheAware 函数（wdm.h）

项目
02/07/2025

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