KeInitializeGuardedMutex function (wdm.h)

The KeInitializeGuardedMutex routine initializes a guarded mutex.

Syntax

void KeInitializeGuardedMutex(
  [out] PKGUARDED_MUTEX Mutex
);

Parameters

[out] Mutex

Pointer to the KGUARDED_MUTEX structure to initialize. The storage must be 4-byte aligned on 32-bit platforms, and 8-byte aligned on 64-bit platforms.

Return value

None

Remarks

Guarded mutexes must be allocated from nonpaged pool.

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

Requirements

Requirement Value
Minimum supported client Available in Windows Server 2003 with Service Pack 1 (SP1) and later versions of Windows.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL
DDI compliance rules HwStorPortProhibitedDDIs(storport)

See also

KGUARDED_MUTEX

KeAcquireGuardedMutex