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 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