Функция 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 |