Função KeReadStateEvent (wdm.h)
A rotina KeReadStateEvent retorna o estado atual, sinalizado ou não sinalizado, de um objeto de evento.
LONG KeReadStateEvent(
[in] PRKEVENT Event
);
[in] Event
Um ponteiro para um objeto de evento inicializado para o qual o chamador fornece o armazenamento.
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.
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 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 Event Objects.
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 2000. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (inclua Ntddk.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm) |