ExAcquireFastMutex-Funktion (wdm.h)

Die ExAcquireFastMutex Routine erwirbt den gegebenen schnellen Mutex mit APCs für den aktuellen Thread deaktiviert.

Syntax

VOID ExAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

Parameter

FastMutex

[in, out] Ein Zeiger auf einen initialisierten schnellen Mutex, für den der Aufrufer den Speicher bereitstellt.

Rückgabewert

Nichts

Bemerkungen

ExAcquireFastMutex den Aufrufer in einen Wartezustand versetzt, wenn der angegebene schnelle Mutex nicht sofort erworben 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.

Jeder schnelle Mutex, der mit ExAcquireFastMutex oder ExTryToAcquireFastMutex erworben wird, muss mit ExReleaseFastMutexfreigegeben werden.

Weitere Informationen zu schnellen Mutexen finden Sie unter Fast Mutexes und Guarded Mutexes.

Aufrufer von ExAcquireFastMutex- müssen unter IRQL-<= APC_LEVEL ausgeführt werden. ExAcquireFastMutex legt die IRQL auf APC_LEVEL fest, und der Aufrufer wird nach Rückgabe von ExAcquireFastMut ex weiterhin bei APC_LEVEL ausgeführt. ExAcquireFastMutex speichert die vorherige IRQL des Aufrufers jedoch im Mutex, und diese IRQL wird wiederhergestellt, wenn der Aufrufer ExReleaseFastMutexaufruft.

Anforderungen

Siehe auch

FAST_MUTEX

ExAcquireFastMutexUnsafe

ExInitializeFastMutex

ExReleaseFastMutex-

ExTryToAcquireFastMutex