ExTryToAcquireFastMutex, fonction (wdm.h)
La routine ExTryToAcquireFastMutex acquiert le mutex rapide donné, si possible, avec les API du thread actuel désactivés.
Syntaxe
BOOLEAN ExTryToAcquireFastMutex(
PFAST_MUTEX FastMutex
);
Paramètres
FastMutex
[in, out] Pointeur vers le mutex rapide à acquérir s’il n’est pas actuellement détenu par un autre thread.
Valeur retournée
ExTryToAcquireFastMutex retourne TRUE si le thread actuel est propriétaire du mutex rapide.
Remarques
Si le mutex rapide donné n’est actuellement pas propriétaire, ExTryToAcquireFastMutex donne à l’appelant la propriété avec les API au thread actuel désactivé jusqu’à ce qu’il libère le mutex rapide.
Utilisez ExAcquireFastMutex si le thread actuel doit attendre l’acquisition du mutex donné avant de pouvoir effectuer un travail utile.
Tout mutex rapide acquis avec ExTryToAcquireFastMutex ou ExAcquireFastMutex doit être libéré avec ExReleaseFastMutex.
Pour plus d’informations sur les mutex rapides, consultez Mutexes rapides et Mutex guarded.
Les appelants d’ExTryToAcquireFastMutex doivent s’exécuter sur IRQL <= APC_LEVEL. ExTryToAcquireFastMutex définit l’IRQL sur APC_LEVEL si le mutex est acquis et que l’appelant continue à s’exécuter à APC_LEVEL après le retour d’ExTryToAcquireFastMutex . ExTryToAcquireFastMutex enregistre l’IRQL précédent de l’appelant dans le mutex en cas de réussite, cependant, et que IRQL est restauré lorsque l’appelant appelle ExReleaseFastMutex.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 |
| En-tête | wdm.h |
| IRQL | <= APC_LEVEL |
| Règles de conformité DDI | HwStorPortProhibitedDDIs(storport), IrqlExApcLte1(wdm) |