Export (0) Print
Expand All
Expand Minimize

KeInitializeMutex routine

The KeInitializeMutex routine initializes a mutex object, setting it to a signaled state.

Syntax


VOID KeInitializeMutex(
  _Out_  PRKMUTEX Mutex,
  _In_   ULONG Level
);

Parameters

Mutex [out]

Pointer to a mutex object, for which the caller provides the storage.

Level [in]

Reserved. Drivers set this to zero.

Return value

None

Remarks

For better performance, use fast mutexes or guarded mutexes. For more information, see Alternatives to Mutex Objects.

The mutex object is initialized with an initial state of signaled.

Storage for a mutex object must be resident: in the device extension of a driver-created device object, in the controller extension of a driver-created controller object, or in nonpaged pool allocated by the caller.

For more information about mutex objects, see Mutex Objects.

Requirements

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

Any level

DDI compliance rules

HwStorPortProhibitedDDIs

See also

ExInitializeFastMutex
KeReadStateMutex
KeReleaseMutex
KeWaitForMultipleObjects
KeWaitForMutexObject
KeWaitForSingleObject

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft