ExAcquireRundownProtectionCacheAwareEx 函数 (wdm.h)

项目
02/27/2024

ExAcquireRundownProtectionCacheAwareEx 例程尝试在共享对象上获取缓存感知的运行保护，以便调用方可以安全地访问该对象。

语法

BOOLEAN ExAcquireRundownProtectionCacheAwareEx(
  [in, out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware,
  [in]      ULONG                       Count
);

参数

[in, out] RunRefCacheAware

指向前一次调用 ExAllocateCacheAwareRundownProtection 或 ExInitializeRundownProtectionCacheAware 返回的不透明EX_RUNDOWN_REF_CACHE_AWARE结构的指针。

[in] Count

要递增到对象的运行实例计数的量。仅当例程返回 TRUE 时，计数才会递增。有关详细信息，请参阅“备注”。

返回值

如果例程成功为调用方获取运行保护，ExAcquireRundownProtectionCacheAwareEx 将返回 TRUE。否则，它将返回 FALSE。返回值为 FALSE 表示对象的运行已启动，并且必须将对象视为无效。

注解

RunRefCacheAware 参数指向跟踪关联对象的运行状态的EX_RUNDOWN_REF_CACHE_AWARE结构。此状态信息包括当前对对象有效的缓存感知运行保护实例计数。 ExAcquireRundownProtectionCacheAwareEx 和 ExReleaseRundownProtectionCacheAwareEx 例程按任意数量递增和递减此计数。两个相关的例程 （ExAcquireRundownProtectionCacheAware 和 ExReleaseRundownProtectionCacheAware）递增和递减此计数。

只要运行块本身是非分页的，就可以在DISPATCH_LEVEL调用此函数。

有关详细信息，请参阅缓存感知的运行保护。