Поделиться через


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

Подпрограмма 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)

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

KeClearEvent

KeInitializeEvent

KeResetEvent

KeSetEvent

KeWaitForSingleObject