Partager via


KeInitializeMutex, fonction (wdm.h)

Le KeInitializeMutex routine initialise un objet mutex, le définissant sur un état signalé.

Syntaxe

void KeInitializeMutex(
  [out] PRKMUTEX Mutex,
  [in]  ULONG    Level
);

Paramètres

[out] Mutex

Pointeur vers un objet mutex pour lequel l’appelant fournit le stockage. Le stockage doit être aligné sur 4 octets sur des plateformes 32 bits et alignés sur des plateformes 64 bits.

[in] Level

Réservé. Les pilotes définissent cette valeur sur zéro.

Valeur de retour

Aucun

Remarques

Pour de meilleures performances, utilisez des mutex rapides ou des mutex gardeux. Pour plus d’informations, consultez Alternatives aux objets Mutex.

L’objet mutex est initialisé avec un état initial de signal.

Le stockage d’un objet mutex doit être résident : dans l’extension de périphérique d’un objet de périphérique créé par le pilote, dans l’extension du contrôleur d’un objet de contrôleur créé par un pilote ou dans un pool nonpage alloué par l’appelant.

Pour plus d’informations sur les objets mutex, consultez objets Mutex.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows 2000.
plateforme cible Universel
d’en-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL N’importe quel niveau
règles de conformité DDI HwStorPortProhibitedDDIs(storport)

Voir aussi

ExInitializeFastMutex

keReadStateMutex

KeReleaseMutex

KeWaitForMultipleObjects

KeWaitForSingleObject