Fonction KeReadStateMutex (wdm.h)
La routine KeReadStateMutex retourne l’état actuel, signalé ou non, de l’objet mutex spécifié.
Syntaxe
LONG KeReadStateMutex(
[in] PRKMUTEX Mutex
);
Paramètres
[in] Mutex
Pointeur vers un objet mutex initialisé pour lequel l’appelant fournit le stockage.
Valeur retournée
Si la valeur de retour est 1, l’état de l’objet mutex est signalé.
Remarques
Cette routine fournit un moyen efficace d’interroger l’état du signal d’un mutex. KeReadStateMutex lit l’état du mutex sans synchroniser son accès au mutex. Ne partez pas du principe que les accès d’un état mutex par KeReadStateMutex s’excluent mutuellement des accès par des routines, telles que KeReleaseMutex et KeWaitForSingleObject, qui synchronisent leur accès à l’état mutex.
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 | <= DISPATCH_LEVEL |
| Règles de conformité DDI | HwStorPortProhibitedDDIs(storport) |