Função KeReadStateEvent (wdm.h)

  • Artigo

A rotina KeReadStateEvent retorna o estado atual, sinalizado ou não sinalizado, de um objeto de evento.

Sintaxe

LONG KeReadStateEvent(
  [in] PRKEVENT Event
);

Parâmetros

[in] Event

Um ponteiro para um objeto de evento inicializado para o qual o chamador fornece o armazenamento.

Retornar valor

Se o objeto de evento estiver atualmente definido como um estado sinalizado, um valor diferente de zero será retornado. Caso contrário, zero será retornado.

Comentários

Essa rotina fornece uma maneira eficiente de sondar o estado do sinal de um evento. KeReadStateEvent lê o estado do evento sem sincronizar seu acesso ao evento. Não suponha que os acessos de um estado de evento por KeReadStateEvent sejam mutuamente exclusivos de acessos por rotinas, como KeSetEvent e KeWaitForSingleObject, que sincronizam seu acesso ao estado do evento.

Também é possível ler o estado de um evento da rotina de serviço de interrupção de um driver no DIRQL, se as seguintes condições forem atendidas: o objeto de evento do driver é residente (provavelmente em sua extensão de dispositivo) e qualquer outra função que acesse o evento sincroniza seu acesso com o ISR.

Para obter mais informações sobre objetos de evento, consulte Objetos de Evento.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho wdm.h (inclua Ntddk.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm)

Confira também

KeClearEvent

KeInitializeEvent

KeResetEvent

KeSetEvent

KeWaitForSingleObject