Fonction ExAcquireFastMutexUnsafe (wdm.h)

Article
03/01/2024

La routine ExAcquireFastMutexUnsafe acquiert le mutex rapide spécifié pour le thread appelant.

Syntaxe

void ExAcquireFastMutexUnsafe(
  PFAST_MUTEX FastMutex
);

Paramètres

FastMutex

[in, out] Pointeur vers une structure FAST_MUTEX) pour laquelle l’appelant fournit le stockage. L’appelant a précédemment initialisé cette structure par un appel à la routine ExInitializeFastMutex

Valeur de retour

None

Remarques

ExAcquireFastMutexUnsafe place l’appelant dans un état d’attente si le mutex rapide spécifié ne peut pas être acquis immédiatement. Sinon, l’appelant est propriétaire du mutex et dispose d’un accès exclusif à la ressource que le mutex protège jusqu’à ce que l’appelant libère le mutex.

Tout mutex rapide acquis par un appel à ExAcquireFastMutexUnsafe doit être libéré par un appel à la routine ExReleaseFastMutexUnsafe .

Les routines ExAcquireFastMutex et ExAcquireFastMutexUnsafe provoquent le blocage du thread appelant jusqu’à ce que le mutex soit disponible. La routine ExTryToAcquireFastMutex retourne immédiatement avec la valeur de retour FALSE si un autre thread a déjà acquis le mutex. ExAcquireFastMutex et ExTryToAcquireFastMutex lèvent l’IRQL à APC_LEVEL avant d’acquérir le mutex rapide. Les pilotes doivent utiliser ExAcquireFastMutexUnsafe, qui ne déclenche pas l’IRQL, uniquement si l’une des conditions suivantes est vraie :

Le thread est déjà en cours d’exécution à APC_LEVEL.
Le thread acquiert le mutex dans une région critique précédemment entrée par un appel à la routine KeEnterCriticalRegion ou FsRtlEnterFileSystem .

Pour plus d’informations sur les mutex rapides, consultez les rubriques suivantes :

Mutex rapides et mutex surveillés

Verrous, interblocages et synchronisation