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

Статья
02/07/2025

Программа ExReInitializeRundownProtectionCacheAware повторно инициализирует структуру EX_RUNDOWN_REF_CACHE_AWARE после запуска связанного объекта.

Синтаксис

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

Параметры

[in, out] RunRefCacheAware

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

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

Никакой

Замечания

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

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

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

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

Требования

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