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

Статья
03/01/2024

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

Синтаксис

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

Параметры

[in, out] RunRefCacheAware

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

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

None

Remarks

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

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

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

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

Требования

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