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

  • Статья

Подпрограмма ExInitializeRundownProtection инициализирует защиту от запуска общего объекта.

Синтаксис

void ExInitializeRundownProtection(
  [out] PEX_RUNDOWN_REF RunRef
);

Параметры

[out] RunRef

Указатель на инициализируемый EX_RUNDOWN_REF структуры, выделенной вызывающим объектом. Выделение должно быть выровнено по 4 байтам на 32-разрядных платформах и 8-байтовое выравнивание на 64-разрядных платформах. Дополнительные сведения см. в подразделе "Примечания".

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

None

Remarks

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

Необходимо вызвать ExInitializeRundownProtection , чтобы инициализировать структуру EX_RUNDOWN_REF , прежде чем она будет передана в качестве параметра в любую другую подпрограмму защиты.

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

После инициализации структуры EX_RUNDOWN_REF другие драйверы, обращающиеся к связанному объекту, могут вызывать подпрограммы ExAcquireRundownProtection и ExReleaseRundownProtection для получения и освобождения защиты от запуска объекта.

Дополнительные сведения см. в разделе Защита от запуска.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows XP.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

См. также раздел

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExReleaseRundownProtection