Функция KeReadStateEvent (wdm.h)
Подпрограмма KeReadStateE vent возвращает текущее состояние, сигнал или не сигнальный объект события.
Синтаксис
LONG KeReadStateEvent(
[in] PRKEVENT Event
);
Параметры
[in] Event
Указатель на инициализированный объект события, для которого вызывающий объект предоставляет хранилище.
Возвращаемое значение
Если объект события в настоящее время имеет сигнальное состояние, возвращается ненулевое значение. В противном случае возвращается ноль.
Замечания
Эта подпрограмма обеспечивает эффективный способ опроса состояния сигнала события. KeReadStateEvent считывает состояние события без синхронизации доступа к событию. Не предполагайте, что доступ к состоянию события KeReadStateEvent взаимоисключает доступ по подпрограммам, таким как KeSetEvent и KeWaitForSingleObject, которые синхронизируют доступ к состоянию события.
Кроме того, можно считывать состояние события из подпрограммы прерываний драйвера в DIRQL, если выполняются следующие условия: объект события драйвера является резидентом (вероятно, в расширении устройства), а любая другая функция, которая обращается к событию, синхронизирует его доступ с ISR.
Дополнительные сведения об объектах событий см. в объектов событий.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 2000. |
| целевая платформа | Всеобщий |
| заголовка | wdm.h (include Ntddk.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| правил соответствия DDI | HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm) |