KeAcquireGuardedMutexUnsafe - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// wdm.h

VOID KeAcquireGuardedMutexUnsafe(
  PKGUARDED_MUTEX FastMutex
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-wdm-keacquireguardedmutexunsafe)

Description

The KeAcquireGuardedMutexUnsafe acquires a guarded mutex while inside a guarded region.

Parameters

FastMutex

[in, out] Pointer to the KGUARDED_MUTEX structure for the guarded mutex.

Remarks

Use KeReleaseGuardedMutexUnsafe to release a guarded mutex acquired with KeAcquireMutexUnsafe.

KeAcquireGuardedMutexUnsafe does not implicitly place the calling thread within a guarded region. Code enclosed within a KeAcquireGuardedMutexUnsafe/KeReleaseGuardedMutexUnsafe pair must execute either at IRQL = APC_LEVEL, or within a guarded region. For code that is not guaranteed to execute within a guarded region, use KeAcquireGuardedMutex and KeReleaseGuardedMutexUnsafe.

A guarded mutex cannot be acquired recursively: if a thread is already holding the mutex when it calls KeAcquireGuardedMutexUnsafe, the thread will deadlock.

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

See also

KGUARDED_MUTEX

KeReleaseGuardedMutexUnsafe