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