ExInitializeFastMutex, fonction (wdm.h)

Article
02/29/2024

La routine ExInitializeFastMutex initialise une variable mutex rapide, utilisée pour synchroniser l’accès mutuellement exclusif par un ensemble de threads à une ressource partagée.

Syntaxe

void ExInitializeFastMutex(
  [out] PFAST_MUTEX FastMutex
);

Paramètres

[out] FastMutex

Pointeur vers une structure de FAST_MUTEX allouée à l’appelant, qui représente le mutex rapide, dans le pool de mémoire non paginé. L’allocation doit être alignée sur 4 octets sur les plateformes 32 bits et sur 8 octets sur les plateformes 64 bits.

Valeur de retour

None

Remarques

ExInitializeFastMutex doit être appelé avant tout appel à d’autres routines ExXxxFastMutex .

Bien que l’appelant fournisse le stockage pour le mutex rapide donné, la structure FAST_MUTEX est opaque : c’est-à-dire que ses membres sont réservés à l’utilisation du système.

Pour de meilleures performances, utilisez les routines ExXxxFastMutex au lieu des routines KeXxxMutex . Toutefois, un mutex rapide ne peut pas être acquis de manière récursive, comme le peut un mutex de noyau.

Pour plus d’informations sur les mutex rapides, consultez Mutexes rapides et Mutex guarded.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL