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

  • Статья

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

Синтаксис

LONG KeReadStateSemaphore(
  [in] PRKSEMAPHORE Semaphore
);

Параметры

[in] Semaphore

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

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

Если возвращаемое значение равно нулю, объекту семафора присваивается состояние без сигнала.

Комментарии

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

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

Требования

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

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

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForSingleObject