Функция ExAcquireRundownProtectionCacheAwareEx (wdm.h)

Статья
02/27/2024

Подпрограмма ExAcquireRundownProtectionCacheAwareEx пытается получить защиту от запуска с учетом кэша для общего объекта, чтобы вызывающий объект смог безопасно получить доступ к объекту.

Синтаксис

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

Параметры

[in, out] RunRefCacheAware

Указатель на непрозрачную структуру EX_RUNDOWN_REF_CACHE_AWARE , возвращенную предыдущим вызовом ExAllocateCacheAwareRundownProtection или ExInitializeRundownProtectionCacheAware.

[in] Count

Сумма, на которую увеличивается число запущенных экземпляров объекта. Счетчик увеличивается, только если подпрограмма возвращает значение TRUE. Дополнительные сведения см. в подразделе "Примечания".

Возвращаемое значение

ExAcquireRundownProtectionCacheAwareEx возвращает значение TRUE , если подпрограмма успешно получает защиту от запуска вызывающей стороны. В противном случае возвращается значение FALSE. Возвращаемое значение FALSE указывает, что запущен запуск объекта и что объект должен рассматриваться как недопустимый.

Параметр RunRefCacheAware указывает на структуру EX_RUNDOWN_REF_CACHE_AWARE , которая отслеживает состояние запуска связанного объекта. Эти сведения о состоянии включают количество экземпляров защиты от запуска с учетом кэша, которые в настоящее время действуют на объекте . Подпрограммы ExAcquireRundownProtectionCacheAwareEx и ExReleaseRundownProtectionCacheAwareEx увеличивают и уменьшают это число на произвольные суммы. Две связанные подпрограммы , ExAcquireRundownProtectionCacheAware и ExReleaseRundownProtectionCacheAware, увеличивают и уменьшают это число на единицу.

До тех пор, пока блок выполнения не загвоздивается, эту функцию можно вызывать по DISPATCH_LEVEL.

Дополнительные сведения см. в разделе Защита от запуска с учетом кэша.

Требования

Требование	Значение
Минимальная версия сервера	Windows Server 2003 с пакетом обновления 1 (SP1)
Верхняя часть	wdm.h (включая Wdm.h)
Правила соответствия DDI	HwStorPortProhibitedDIs(storport)