ExTryToAcquireFastMutex, fonction (wdm.h)
Le ExTryToAcquireFastMutex routine acquiert le mutex rapide donné, si possible, avec les API sur le thread actuel désactivé.
Syntaxe
BOOLEAN ExTryToAcquireFastMutex(
PFAST_MUTEX FastMutex
);
Paramètres
FastMutex
[in, out] Pointeur vers le mutex rapide à acquérir s’il n’est actuellement pas détenu par un autre thread.
Valeur de retour
ExTryToAcquireFastMutex retourne TRUE si le thread actuel reçoit la propriété du mutex rapide.
Remarques
Si le mutex rapide donné n’est pasowned, ExTryToAcquireFastMutex donne la propriété de l’appelant 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 doivent être libérés avec ExReleaseFastMutex.
Pour plus d’informations sur les mutex rapides, consultez Mutexes rapides et mutexes guarded.
Les appelants de ExTryToAcquireFastMutex doivent s’exécuter à l'<IRQL = APC_LEVEL. ExTryToAcquireFastMutex définit l’IRQL sur APC_LEVEL si le mutex est acquis, et l’appelant continue à s’exécuter à APC_LEVEL après ExTryToAcquireFastMutex retourne. ExTryToAcquireFastMutex enregistre l’IRQL précédent de l’appelant dans le mutex en cas de réussite et 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) |