Funzione KeReadStateEvent (wdm.h)
La routine KeReadStateE vent 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 la risorsa di archiviazione.
Valore restituito
Se l'oggetto evento è attualmente impostato su uno stato segnalato, viene restituito un valore diverso da zero. In caso contrario, viene restituito zero.
Osservazioni
Questa routine consente di eseguire il polling efficiente dello stato del segnale di un evento. KeReadStateEvent legge lo stato dell'evento senza sincronizzarne l'accesso all'evento. Non presupporre che gli accessi di uno stato di evento da KeReadStateEvent si escludono a vicenda dagli 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 del servizio interrupt di un 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.
Fabbisogno
| 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 | HwStorPortProhibitedDDIs(storport), IrqlKeDispatchLte(wdm) |