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