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

Статья
08/08/2023

Подпрограмма KeReadStateEvent возвращает текущее состояние объекта события (по сигналу или без сигнала).

Синтаксис

LONG KeReadStateEvent(
  [in] PRKEVENT Event
);

Параметры

[in] Event

Указатель на инициализированный объект события, для которого вызывающий объект предоставляет хранилище.

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

Если объект события в настоящее время имеет состояние сигнального, возвращается ненулевое значение. Иначе возвращается нуль.

Эта подпрограмма предоставляет эффективный способ опроса состояния сигнала события. KeReadStateEvent считывает состояние события без синхронизации его доступа к событию. Не следует предполагать, что доступ keReadStateEvent к состоянию события является взаимоисключающим доступом подпрограмм, таких как KeSetEvent и KeWaitForSingleObject, которые синхронизируют свой доступ к состоянию события.

Кроме того, можно считывать состояние события из подпрограммы прерывания драйвера в DIRQL, если выполняются следующие условия: объект события драйвера является резидентным (вероятно, в расширении устройства), а любая другая функция, которая обращается к событию, синхронизирует свой доступ с ISR.

Дополнительные сведения об объектах событий см. в разделе Объекты событий.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 2000.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Ntddk.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm)

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

KeWaitForSingleObject