Condividi tramite


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 lo spazio di archiviazione.

Valore restituito

Se il valore restituito è zero, l'oggetto semaforo viene impostato su uno stato senza segnale.

Osservazioni

Questa routine fornisce 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 presupporre che gli accessi di uno stato semaforo da KeReadStateSemaphore si escludono a vicenda dagli accessi da routine, ad esempio KeReleaseSemaphore e KeWaitForSingleObject, che sincronizzano l'accesso allo stato semaforo.

Per altre informazioni sugli oggetti semaforo, vedere Semaphore Objects.

Fabbisogno

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 HwStorPortProhibitedDDIs(storport)

Vedere anche

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForSingleObject