Export (0) Print
Expand All
Expand Minimize

ExInitializeFastMutex routine

The ExInitializeFastMutex routine initializes a fast mutex variable, used to synchronize mutually exclusive access by a set of threads to a shared resource.

Syntax


VOID ExInitializeFastMutex(
  _Out_  PFAST_MUTEX FastMutex
);

Parameters

FastMutex [out]

A pointer to a caller-allocated FAST_MUTEX structure, which represents the fast mutex, in the nonpaged memory pool.

Return value

None

Remarks

ExInitializeFastMutex must be called before any calls to other ExXxxFastMutex routines occur.

Although the caller supplies the storage for the given fast mutex, the FAST_MUTEX structure is opaque: that is, its members are reserved for system use.

For better performance, use the ExXxxFastMutex routines instead of the KeXxxMutex routines. However, a fast mutex cannot be acquired recursively, as a kernel mutex can.

For more information about fast mutexes, see Fast Mutexes and Guarded Mutexes.

Requirements

Version

Available starting with Windows 2000.

Header

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

Library

Ntoskrnl.lib

IRQL

<= DISPATCH_LEVEL

See also

FAST_MUTEX
ExAcquireFastMutex
ExAcquireFastMutexUnsafe
ExReleaseFastMutex
ExReleaseFastMutexUnsafe
ExTryToAcquireFastMutex
KeInitializeMutex

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft