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

2025-02-07

Подпрограмма 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 (include Wdm.h)
правил соответствия DDI	HwStorPortProhibitedDIs(storport)