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

Статья
02/07/2025

Программа ExAllocateCacheAwareRundownProtection выделяет структуру защиты запуска с поддержкой кэша для сценариев с несколькими процессорами. Защита rundown — это механизм синхронизации, позволяющий безопасно очистить ресурсы, к которым может обращаться несколько потоков.

Синтаксис

PEX_RUNDOWN_REF_CACHE_AWARE ExAllocateCacheAwareRundownProtection(
  [in] __drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType,
  [in] ULONG                                          PoolTag
);

Параметры

[in] PoolType

Тип выделяемой памяти пула. Описание доступных типов памяти пула см. в POOL_TYPE.

[in] PoolTag

ULONG, указывающий тег пула для выделения памяти. Тег пула — это 32-разрядное значение, используемое для отслеживания использования памяти.

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

Возвращает указатель на непрозрачную EX_RUNDOWN_REF_CACHE_AWARE структуру или ЗНАЧЕНИЕ NULL, если выделение завершается ошибкой.

Замечания

Драйвер может вызывать ExAllocateCacheAwareRundownProtection в качестве альтернативы вызову ExSizeOfRundownProtectionCacheAware за ExInitializeRundownProtectionCacheAware.

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

Требования

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