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

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

Синтаксис

void ExInitializeRundownProtection(
  [out] PEX_RUNDOWN_REF RunRef
);

Параметры

[out] RunRef

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

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

Никакой

Замечания

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

exInitializeRundownProtection необходимо вызвать для инициализации структуры EX_RUNDOWN_REF перед передачей в качестве параметра любой другой подпрограмме защиты от запуска.

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

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

Дополнительные сведения см. в разделе Run-Down Protection.

Требования

См. также

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExReleaseRundownProtection