ExAcquireFastMutex-Funktion (wdm.h)
Die ExAcquireFastMutex-Routine ruft den angegebenen schnellen Mutex ab, wobei APCs zum aktuellen Thread deaktiviert sind.
Syntax
void ExAcquireFastMutex(
PFAST_MUTEX FastMutex
);
Parameter
FastMutex
[ein, aus] Ein Zeiger auf einen initialisierten schnellen Mutex, für den der Aufrufer den Speicher bereitstellt.
Rückgabewert
Keine
Bemerkungen
ExAcquireFastMutex versetzt den Aufrufer in einen Wartezustand, wenn der angegebene schnelle Mutex nicht sofort abgerufen werden kann. Andernfalls erhält der Aufrufer den Besitz des schnellen Mutex mit APCs für den aktuellen Thread, der deaktiviert ist, bis er den schnellen Mutex freigibt.
Verwenden Sie ExTryToAcquireFastMutex , wenn der aktuelle Thread andere Aufgaben ausführen kann, bevor er auf den Erwerb des angegebenen Mutex wartet.
Alle schnellen Mutex,die mit ExAcquireFastMutex oder ExTryToAcquireFastMutex erworben werden, müssen mit ExReleaseFastMutex freigegeben werden.
Weitere Informationen zu schnellen Mutexes finden Sie unter Fast Mutexes und Guarded Mutexes.
Aufrufer von ExAcquireFastMutex müssen unter IRQL <= APC_LEVEL ausgeführt werden. ExAcquireFastMutex legt den IRQL auf APC_LEVEL fest, und der Aufrufer wird nach der Rückgabe von ExAcquireFastMutex weiterhin bei APC_LEVEL ausgeführt. ExAcquireFastMutex speichert jedoch die vorherige IRQL des Aufrufers im Mutex, und dieser IRQL wird wiederhergestellt, wenn der Aufrufer ExReleaseFastMutex aufruft.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 |
| Kopfzeile | wdm.h |
| IRQL | <= APC_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), IrqlExApcLte1(wdm) |