Fonction ExAcquireFastMutex (wdm.h)

  • Article

La routine ExAcquireFastMutex acquiert le mutex rapide donné avec des API pour 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

None

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 des 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 d’ExAcquireFastMutex ou d’ExTryToAcquireFastMutex doit être libéré avec ExReleaseFastMutex.

Pour plus d’informations sur les mutex rapides, consultez Mutexes rapides et Mutexes gardés.

Les appelants d’ExAcquireFastMutex doivent être en cours d’exécution à IRQL <= APC_LEVEL. ExAcquireFastMutex définit l’IRQL sur APC_LEVEL, et l’appelant continue à s’exécuter à APC_LEVEL après le retour d’ExAcquireFastMutex . Toutefois, ExAcquireFastMutex enregistre l’IRQL précédent de l’appelant dans le mutex et que l’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

ExAcquireFastMutexUnsafe

ExInitializeFastMutex

ExReleaseFastMutex

ExTryToAcquireFastMutex