Funzione KeReadStateEvent (wdm.h)

Articolo
02/29/2024

La routine KeReadStateEvent restituisce lo stato corrente, segnalato o non segnalato, di un oggetto evento.

Sintassi

LONG KeReadStateEvent(
  [in] PRKEVENT Event
);

Parametri

[in] Event

Puntatore a un oggetto evento inizializzato per il quale il chiamante fornisce l'archiviazione.

Valore restituito

Se l'oggetto evento è attualmente impostato su uno stato segnalato, viene restituito un valore diverso da zero. In caso contrario, sarà restituito zero.

Commenti

Questa routine offre un modo efficiente per eseguire il polling dello stato del segnale di un evento. KeReadStateEvent legge lo stato dell'evento senza sincronizzarne l'accesso all'evento. Non si supponga che gli accessi di uno stato di evento da KeReadStateEvent siano reciprocamente esclusivi degli accessi da routine, ad esempio KeSetEvent e KeWaitForSingleObject, che sincronizzano l'accesso allo stato dell'evento.

È anche possibile leggere lo stato di un evento dalla routine di interruzione del driver in DIRQL, se vengono soddisfatte le condizioni seguenti: l'oggetto evento del driver è residente (probabilmente nell'estensione del dispositivo) e qualsiasi altra funzione che accede all'evento sincronizza l'accesso con l'ISR.

Per altre informazioni sugli oggetti evento, vedere Oggetti evento.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Ntddk.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDDIs(storport), IrqlKeDispatchLte(wdm)