Función KeReadStateEvent (wdm.h)

  • Artículo

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)

Consulte también

KeClearEvent

KeInitializeEvent

KeResetEvent

KeSetEvent

KeWaitForSingleObject