展开 最小化

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

Target platform

Universal

Version

Available starting with Windows 2000.

Header

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

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

Any level

DDI compliance rules

HwStorPortProhibitedDDIs

See also

ExInitializeFastMutex
KeReadStateMutex
KeReleaseMutex
KeWaitForMultipleObjects
KeWaitForMutexObject
KeWaitForSingleObject

 

 

Send comments about this topic to Microsoft

显示:
© 2015 Microsoft