ExTryToAcquireFastMutex-Funktion (wdm.h)
Die ExTryToAcquireFastMutex Routine erwirbt den gegebenen schnellen Mutex, sofern möglich, mit APCs zum aktuellen Thread deaktiviert.
Syntax
BOOLEAN ExTryToAcquireFastMutex(
PFAST_MUTEX FastMutex
);
Parameter
FastMutex
[in, out] Ein Zeiger auf den schnellen Mutex, der abgerufen werden soll, wenn er derzeit nicht im Besitz eines anderen Threads ist.
Rückgabewert
ExTryToAcquireFastMutex gibt TRUE zurück, wenn der aktuelle Thread den Besitz des schnellen Mutex erhält.
Bemerkungen
Wenn der angegebene schnelle Mutex zurzeit nicht freigegeben ist, ExTryToAcquireFastMutex dem Aufrufer den Besitz mit APCs an den aktuellen Thread deaktiviert, bis er den schnellen Mutex freigibt.
Verwenden Sie ExAcquireFastMutex, wenn der aktuelle Thread auf den Erwerb des angegebenen Mutex warten muss, bevor es nützliche Arbeit leisten kann.
Jeder schnelle Mutex, der mit ExTryToAcquireFastMutex oder ExAcquireFastMutex erworben wird, muss mit ExReleaseFastMutexfreigegeben werden.
Weitere Informationen zu schnellen Mutexen finden Sie unter Fast Mutexes und Guarded Mutexes.
Aufrufer von ExTryToAcquireFastMutex- müssen unter IRQL-<= APC_LEVEL ausgeführt werden. ExTryToAcquireFastMutex legt die IRQL auf APC_LEVEL fest, wenn der Mutex abgerufen wird, und der Aufrufer wird nach Von ExTryToAcquireFastMutex bei APC_LEVEL weiter ausgeführt. ExTryToAcquireFastMutex speichert die vorherige IRQL des Anrufers im Mutex, wenn dies erfolgreich ist, und diese IRQL wird wiederhergestellt, wenn der Aufrufer ExReleaseFastMutexaufruft.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 |
| Header- | wdm.h |
| IRQL- | <= APC_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), IrqlExApcLte1(wdm) |