Fonction KeReadStateMutex (wdm.h)

  • Article

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)

Voir aussi

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject