ExTryToAcquireFastMutex-Funktion (wdm.h)

  • Artikel

Die ExTryToAcquireFastMutex-Routine ruft nach Möglichkeit den angegebenen schnellen Mutex ab, wobei APCs zum aktuellen Thread deaktiviert sind.

Syntax

BOOLEAN ExTryToAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

Parameter

FastMutex

[ein, aus] Ein Zeiger auf den schnellen Mutex, der abgerufen werden soll, wenn er sich derzeit nicht im Besitz eines anderen Threads befindet.

Rückgabewert

ExTryToAcquireFastMutex gibt TRUE zurück, wenn dem aktuellen Thread der Besitz des schnellen Mutex verliehen wird.

Hinweise

Wenn der angegebene schnelle Mutex derzeit nicht vorhanden ist, gibt ExTryToAcquireFastMutex dem Aufrufer den Besitz mit APCs für den aktuellen Thread, der deaktiviert ist, bis er den schnellen Mutex freigibt.

Verwenden Sie ExAcquireFastMutex , wenn der aktuelle Thread auf den Erwerb des angegebenen Mutex warten muss, bevor er nützliche Arbeit leisten kann.

Alle schnellen Mutex,die mit ExTryToAcquireFastMutex oder ExAcquireFastMutex erworben werden, müssen mit ExReleaseFastMutex freigegeben werden.

Weitere Informationen zu schnellen Mutexes 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 der Rückgabe von ExTryToAcquireFastMutex weiterhin auf APC_LEVEL ausgeführt. ExTryToAcquireFastMutex speichert jedoch die vorherige IRQL des Aufrufers im Mutex, wenn dies erfolgreich war, und dass IRQL wiederhergestellt wird, 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

ExAcquireFastMutex

ExInitializeFastMutex

ExReleaseFastMutex