ExAcquireRundownProtectionCacheAwareEx 函数（wdm.h）

项目
02/07/2025

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调用此函数。

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

要求

要求	价值
支持的最低服务器	Windows Server 2003 Service Pack 1
标头	wdm.h （包括 Wdm.h）
DDI 符合性规则	HwStorPortProhibitedDIS（storport）