Funzione KeReadStateEvent (wdm.h)
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) |