ExAcquireFastMutex, fonction (wdm.h)
La routine ExAcquireFastMutex acquiert le mutex rapide donné avec les API sur le thread actuel désactivé.
Syntaxe
void ExAcquireFastMutex(
PFAST_MUTEX FastMutex
);
Paramètres
FastMutex
[in, out] Pointeur vers un mutex rapide initialisé pour lequel l’appelant fournit le stockage.
Valeur de retour
Aucun
Remarques
ExAcquireFastMutex place l’appelant dans un état d’attente si le mutex rapide donné ne peut pas être acquis immédiatement. Sinon, l’appelant reçoit la propriété du mutex rapide avec les API sur le thread actuel désactivé jusqu’à ce qu’il libère le mutex rapide.
Utilisez ExTryToAcquireFastMutex si le thread actuel peut effectuer d’autres tâches avant d’attendre l’acquisition du mutex donné.
Tout mutex rapide acquis à l’aide ExAcquireFastMutex ou ExTryToAcquireFastMutex doit être libéré avec ExReleaseFastMutex.
Pour plus d’informations sur les mutex rapides, consultez Mutexes rapides et mutexes guarded.
Les appelants de ExAcquireFastMutex doivent s’exécuter à l'<IRQL = APC_LEVEL. ExAcquireFastMutex définit l’IRQL sur APC_LEVEL, et l’appelant continue à s’exécuter à APC_LEVEL après ExAcquireFastMutex retourne. ExAcquireFastMutex enregistre l’IRQL précédent de l’appelant dans le mutex, mais que IRQL est restauré lorsque l’appelant appelle ExReleaseFastMutex.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 |
| d’en-tête | wdm.h |
| IRQL | <= APC_LEVEL |
| règles de conformité DDI | HwStorPortProhibitedDDIs(storport), IrqlExApcLte1(wdm) |