KeTryToAcquireGuardedMutex-Funktion (wdm.h)
Die KeTryToAcquireGuardedMutex Routine erwirbt ggf. einen geschützten Mutex.
Syntax
BOOLEAN KeTryToAcquireGuardedMutex(
[in, out] PKGUARDED_MUTEX Mutex
);
Parameter
[in, out] Mutex
Zeiger auf die KGUARDED_MUTEX Struktur für den geschützten Mutex.
Rückgabewert
KeTryToAcquireGuardedMutex gibt TRUE zurück, wenn der Mutex erworben wird, und FALSE andernfalls.
Bemerkungen
Verwenden Sie KeReleaseGuardedMutex-, um den Mutex freizugeben.
KeTryToAcquireGuardedMutex sofort zurück, unabhängig davon, ob sie den Mutex erwerben kann. Verwenden Sie KeAcquireGuardedMutex-, um den aufrufenden Thread in einen Wartezustand zu versetzen, bis Mutex verfügbar ist.
Ein Thread, der KeTryToAcquireGuardedMutex aufruft, implizit einen geschützten Bereich eingibt, in dem alle APCs deaktiviert sind. Sie bleiben deaktiviert, bis der Thread den Mutex mit KeReleaseGuardedMutexloslässt.
Weitere Informationen zu geschützten Mutexen finden Sie unter Fast Mutexes and Guarded Mutexes.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Server 2003 und höheren Versionen von Windows. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport), IrqlKeApcLte1(wdm) |