Função KeReadStateEvent (wdm.h)
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) |