Fonction KeInitializeMutex (wdm.h)

  • Article

La routine KeInitializeMutex initialise un objet mutex, le définissant à 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 les plateformes 32 bits et sur 8 octets sur les plateformes 64 bits.

[in] Level

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

Valeur de retour

None

Remarques

Pour de meilleures performances, utilisez des mutex rapides ou des mutex surveillés. 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 d’appareil d’un objet d’appareil créé par un pilote, dans l’extension de contrôleur d’un objet contrôleur créé par le pilote ou dans un pool non paginé alloué par l’appelant.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 2000.
Plateforme cible Universal
En-tête wdm.h (inclure 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