Функция KeReadStateSemaphore (wdm.h)
Подпрограмма KeReadStateSemaphore возвращает текущее состояние, сигнальное или не сигнальное, указанного объекта семафора.
Синтаксис
LONG KeReadStateSemaphore(
[in] PRKSEMAPHORE Semaphore
);
Параметры
[in] Semaphore
Указатель на инициализированный объект семафора, для которого вызывающий объект предоставляет хранилище.
Возвращаемое значение
Если возвращаемое значение равно нулю, объект семафора имеет состояние без сигнала.
Замечания
Эта подпрограмма обеспечивает эффективный способ опроса состояния сигнала семафора. KeReadStateSemaphore считывает состояние семафора без синхронизации доступа к семафору. Не предполагайте, что доступ к состоянию семафора KeReadStateSemaphore взаимоисключает доступ по подпрограммам, таким как KeReleaseSemaphore и KeWaitForSingleObject, которые синхронизируют доступ к состоянию семафора.
Дополнительные сведения об объектах семафора см. в объектов Семафора.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 2000. |
| целевая платформа | Всеобщий |
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Любой уровень |
| правил соответствия DDI | HwStorPortProhibitedDIs(storport) |