Edit

KeReadStateMutex function (wdm.h)

  • Article

The KeReadStateMutex routine returns the current state, signaled or not-signaled, of the specified mutex object.

Syntax

LONG KeReadStateMutex(
  [in] PRKMUTEX Mutex
);

Parameters

[in] Mutex

Pointer to an initialized mutex object for which the caller provides the storage.

Return value

If the return value is 1, the state of the mutex object is signaled.

Remarks

This routine provides an efficient way to poll the signal state of a mutex. KeReadStateMutex reads the state of the mutex without synchronizing its access to the mutex. Do not assume that accesses of a mutex state by KeReadStateMutex are mutually exclusive of accesses by routines, such as KeReleaseMutex and KeWaitForSingleObject, that do synchronize their access to the mutex state.

For more information about mutex objects, see Mutex Objects.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 2000.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI compliance rules HwStorPortProhibitedDDIs(storport)

See also

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject