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

  • Статья

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

Синтаксис

LONG KeReadStateMutex(
  [in] PRKMUTEX Mutex
);

Параметры

[in] Mutex

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

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

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

Комментарии

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

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

Требования

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

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

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject