KeTryToAcquireGuardedMutex-Funktion (wdm.h)

Die KeTryToAcquireGuardedMutex-Routine ruft einen bewachten Mutex ab, sofern verfügbar.

Syntax

BOOLEAN KeTryToAcquireGuardedMutex(
  [in, out] PKGUARDED_MUTEX Mutex
);

Parameter

[in, out] Mutex

Zeiger auf die KGUARDED_MUTEX-Struktur für den bewachten Mutex.

Rückgabewert

KeTryToAcquireGuardedMutex gibt TRUE zurück, wenn der Mutex abgerufen wird, andernfalls FALSE .

Hinweise

Verwenden Sie KeReleaseGuardedMutex , um den Mutex freizugeben.

KeTryToAcquireGuardedMutex gibt sofort zurück, unabhängig davon, ob der Mutex abgerufen werden kann. Verwenden Sie KeAcquireGuardedMutex , um den aufrufenden Thread in einen Wartezustand zu versetzen, bis mutex verfügbar wird.

Ein Thread, der KeTryToAcquireGuardedMutex aufruft , tritt implizit in eine bewachte Region ein, in der alle APCs deaktiviert sind. Sie bleiben deaktiviert, bis der Thread den Mutex mit KeReleaseGuardedMutex freigibt.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Server 2003 und höheren Versionen von Windows.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), IrqlKeApcLte1(wdm)

Weitere Informationen

KeReleaseGuardedMutex