Función KeReadStateEvent (wdm.h)
La rutina KeReadStateEvent devuelve el estado actual, señalado o no señalado, de un objeto de evento.
Sintaxis
LONG KeReadStateEvent(
[in] PRKEVENT Event
);
Parámetros
[in] Event
Puntero a un objeto de evento inicializado para el que el autor de la llamada proporciona el almacenamiento.
Valor devuelto
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.
Comentarios
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 de 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 reside (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 eventos.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 2000. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Ntddk.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm) |