Поделиться через


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

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

Синтаксис

LONG KeReadStateMutex(
  [in] PRKMUTEX Mutex
);

Параметры

[in] Mutex

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

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

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

Замечания

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно начиная с Windows 2000.
целевая платформа Всеобщий
заголовка wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
библиотеки NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
правил соответствия DDI HwStorPortProhibitedDIs(storport)

См. также

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject