ExReleaseFastMutex, fonction (wdm.h)

Article
02/29/2024

La routine ExReleaseFastMutex libère la propriété d’un mutex rapide qui a été acquis avec ExAcquireFastMutex ou ExTryToAcquireFastMutex.

Syntaxe

void ExReleaseFastMutex(
  PFAST_MUTEX FastMutex
);

Paramètres

FastMutex

[in, out] Pointeur vers le mutex rapide à libérer.

Valeur de retour

None

Remarques

ExReleaseFastMutex libère la propriété du mutex rapide donné et définit l’IRQL sur la valeur à laquelle l’appelant s’exécutait avant d’appeler ExAcquireFastMutex. Si l’IRQL précédent était inférieur à APC_LEVEL, la remise des API au thread actuel est réactivée.

Il s’agit d’une erreur de programmation d’appeler ExReleaseFastMutex avec un FastMutex qui a été acquis à l’aide d’ExAcquireFastMutexUnsafe. Les pilotes doivent libérer un mutex rapide à partir du thread qui l’a acquis. Les mutex rapides doivent être libérés dans l’ordre opposé à l’ordre dans lequel ils ont été acquis.

Pour plus d’informations sur les mutex rapides, consultez Mutexes rapides et Mutex guarded.

Les appelants d’ExReleaseFastMutex doivent s’exécuter sur IRQL = APC_LEVEL. Dans la plupart des cas, l’IRQL est déjà défini sur APC_LEVEL avant l’appel d’ExReleaseFastMutex , car ExAcquireFastMutex a déjà défini l’IRQL sur APC_LEVEL automatiquement. Toutefois, si l’appelant modifie l’IRQL après le retour d’ExAcquireFastMutex , l’appelant doit définir explicitement l’IRQL sur APC_LEVEL avant d’appeler ExReleaseFastMutex.