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)

Vedi anche

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForSingleObject