Funzione KeReadStateSemaphore (wdm.h)
La routine KeReadStateSemaphore restituisce lo stato corrente, segnalato o non segnalato, dell'oggetto semaforo specificato.
Sintassi
LONG KeReadStateSemaphore(
[in] PRKSEMAPHORE Semaphore
);
Parametri
[in] Semaphore
Puntatore a un oggetto semaforo inizializzato per il quale il chiamante fornisce l'archiviazione.
Valore restituito
Se il valore restituito è zero, l'oggetto semaforo è impostato su uno stato non segnalato.
Commenti
Questa routine offre un modo efficiente per eseguire il polling dello stato del segnale di un semaforo. KeReadStateSemaphore legge lo stato del semaforo senza sincronizzarne l'accesso al semaforo. Non si supponga che gli accessi di uno stato di semaforo di KeReadStateSemaphore siano reciprocamente esclusivi degli accessi da routine, ad esempio KeReleaseSemaphore e KeWaitForSingleObject, che sincronizzano l'accesso allo stato del semaforo.
Per altre informazioni sugli oggetti semafori, vedere Semaphore Objects.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Qualsiasi livello |
| Regole di conformità DDI | HwStorPortProhibitedDDDIs(storport) |