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