Partager via


ExInitializeFastMutex, fonction (wdm.h)

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

Voir aussi

ExAcquireFastMutex

ExAcquireFastMutexUnsafe

ExReleaseFastMutex

ExReleaseFastMutexUnsafe

ExTryToAcquireFastMutex

FAST_MUTEX

KeInitializeMutex