Fonction KeInitializeMutex (wdm.h)
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) |