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)

Weitere Informationen

FAST_MUTEX

ExAcquireFastMutexUnsafe

ExInitializeFastMutex

ExReleaseFastMutex

ExTryToAcquireFastMutex