ExTryToAcquireFastMutex, fonction (wdm.h)

  • Article

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)

Voir aussi

FAST_MUTEX

ExAcquireFastMutex

ExInitializeFastMutex

ExReleaseFastMutex