Freigeben über


KeAcquireGuardedMutexUnsafe-Funktion (wdm.h)

Der KeAcquireGuardedMutexUnsafe erwirbt einen bewachten Mutex in einer bewachten Region.

Syntax

void KeAcquireGuardedMutexUnsafe(
  PKGUARDED_MUTEX FastMutex
);

Parameter

FastMutex

[ein, aus] Zeiger auf die KGUARDED_MUTEX-Struktur für den bewachten Mutex.

Rückgabewert

Keine

Bemerkungen

Verwenden Sie KeReleaseGuardedMutexUnsafe , um einen bewachten Mutex freizugeben, der mit KeAcquireMutexUnsafe erworben wurde.

KeAcquireGuardedMutexUnsafe platziert den aufrufenden Thread nicht implizit in einer geschützten Region. Code, der in einem KeAcquireGuardedMutexUnsafe/KeReleaseGuardedMutexUnsafe-Paar eingeschlossen ist, muss entweder bei IRQL = APC_LEVEL oder in einer geschützten Region ausgeführt werden. Verwenden Sie KeAcquireGuardedMutex und KeReleaseGuardedMutexunsafe für Code, der nicht garantiert in einer geschützten Region ausgeführt wird.

Ein bewachter Mutex kann nicht rekursiv abgerufen werden: Wenn ein Thread bereits den Mutex hält, wenn er KeAcquireGuardedMutexUnsafe aufruft, wird der Thread deadlockt.

Weitere Informationen zu bewachten Mutexes finden Sie unter Fast Mutexes und Guarded Mutexes.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Server) Windows Server 2003
Kopfzeile wdm.h
IRQL <= APC_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm)

Weitere Informationen

KGUARDED_MUTEX

KeReleaseGuardedMutexUnsafe