Función KeReadStateEvent (wdm.h)
La rutina KeReadStateEvent devuelve el estado actual, señalado o no señalado, de un objeto de evento.
LONG KeReadStateEvent(
[in] PRKEVENT Event
);
[in] Event
Puntero a un objeto de evento inicializado para el que el autor de la llamada proporciona el almacenamiento.
Si el objeto de evento está establecido actualmente en un estado señalado, se devuelve un valor distinto de cero. De lo contrario, se devuelve cero.
Esta rutina proporciona una manera eficaz de sondear el estado de señal de un evento. KeReadStateEvent lee el estado del evento sin sincronizar su acceso al evento. No suponga que los accesos a un estado de evento por KeReadStateEvent son mutuamente excluyentes de los accesos por rutinas, como KeSetEvent y KeWaitForSingleObject, que sincronizan su acceso al estado del evento.
También es posible leer el estado de un evento de la rutina de servicio de interrupción de un controlador en DIRQL, si se cumplen las condiciones siguientes: el objeto de evento del controlador está residente (probablemente en su extensión de dispositivo) y cualquier otra función que tenga acceso al evento sincroniza su acceso con el ISR.
Para obtener más información sobre los objetos de evento, vea Objetos de evento.
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 2000. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (incluya Ntddk.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | <= DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm) |