Partager via


KeReadStateSemaphore, fonction (wdm.h)

La routine KeReadStateSemaphore retourne l’état actuel, signalé ou non signalé, de l’objet sémaphore spécifié.

Syntaxe

LONG KeReadStateSemaphore(
  [in] PRKSEMAPHORE Semaphore
);

Paramètres

[in] Semaphore

Pointeur vers un objet sémaphore initialisé pour lequel l’appelant fournit le stockage.

Valeur de retour

Si la valeur de retour est égale à zéro, l’objet sémaphore est défini sur un état non signalé.

Remarques

Cette routine offre un moyen efficace d’interroger l’état du signal d’un sémaphore. KeReadStateSemaphore lit l’état du sémaphore sans synchroniser son accès au sémaphore. Ne supposez pas que les accès d’un état de sémaphore par KeReadStateSemaphore sont mutuellement exclusifs des accès par routines, tels que KeReleaseSemaphore et KeWaitForSingleObject, qui synchronisent leur accès à l’état du sémaphore.

Pour plus d’informations sur les objets sémaphores, consultez Objets sémaphores.

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

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForSingleObject