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

Статья
02/07/2025

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

Синтаксис

void ExRundownCompletedCacheAware(
  [in, out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
);

Параметры

[in, out] RunRefCacheAware

Указатель на объект защиты rundown, на который будет работать функция. Это указатель на непрозрачную EX_RUNDOWN_REF_CACHE_AWARE структуру, возвращаемую предыдущим вызовом ExAllocateCacheAwareRundownProtection или ExInitializeRundownProtectionCacheAware.

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

Никакой

Замечания

Эта подпрограмма вызывается драйвером, которому принадлежит объект, который находится в общей памяти и к которому обращаются другие драйверы. Вызов ExRundownCompletedCacheAware должен предшествовать вызову ExWaitForRundownProtectionReleaseCacheAware подпрограмме, которая выполняется по объекту.

После вызова ExRundownCompletedCacheAware дополнительные вызовы ExWaitForRundownProtectionReleaseCacheAware, чтобы запустить связанный объект немедленно без ожидания. Однако вызовы ExAcquireRundownProtectionCacheAware для получения защиты от запуска в связанном объекте не удалось (возврат FALSE).

После вызова exRundownCompletedCacheAware драйвер может вызвать подпрограмму ExReInitializeRundownProtectionCacheAware, чтобы связать структуру EX_RUNDOWN_REF_CACHE_AWARE с новым объектом и инициализировать защиту от запуска этого объекта. После вызова ExReInitializeRundownProtect ion драйверы могут вызывать ExAcquireRundownProtectionCacheAware получить защиту от запуска нового объекта.

При входе сведения о состоянии в структуре EX_RUNDOWN_REF_CACHE_AWARE должны указывать на то, что объект, связанный с этой структурой, был запущен.

Требования

Требование	Ценность
минимальный поддерживаемый сервер	Windows Server 2003, пакет обновления 1 (SP1)
заголовка	wdm.h (include Wdm.h)