Fonction KeReadStateSemaphore (wdm.h)

  • Article

La routine KeReadStateSemaphore retourne l’état actuel, signalé ou non, 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 retournée

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

Remarques

Cette routine fournit 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 partez pas du principe que les accès d’un état sémaphore par KeReadStateSemaphore s’excluent mutuellement des accès par des routines, telles 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.

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

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForSingleObject