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) |