Função NdisWaitEvent (ndis.h)

Artigo
02/26/2024

A função NdisWaitEvent coloca o chamador em um estado de espera até que o evento especificado seja definido como o estado Sinalizado ou o tempo limite de espera seja expirado.

Sintaxe

BOOLEAN NdisWaitEvent(
  [in] PNDIS_EVENT Event,
  [in] UINT        MsToWait
);

Parâmetros

[in] Event

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

[in] MsToWait

O número de milissegundos que o chamador aguardará se o evento não estiver definido como o estado sinalizado dentro desse intervalo. Um valor zero especifica que o chamador aguardará o evento indefinidamente.

Retornar valor

NdisWaitEvent retornará TRUE se o evento estiver no estado sinalizado quando a espera for atendida.

Comentários

NdisWaitEvent retorna o controle ao chamador quando o evento especificado é sinalizado ou o intervalo MsToWait especificado expira, o que for mais cedo. Se o evento estiver atualmente no estado sinalizado quando essa chamada ocorrer, NdisWaitEvent retornará o controle imediatamente.

Um driver de miniporto normalmente chama NdisWaitEvent de suas funções MiniportInitializeEx e MiniportHaltEx . Um driver de protocolo normalmente chama NdisWaitEvent de seu ProtocolBindAdapterEx eFunções ProtocolUnbindAdapterEx.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisWaitEvent (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisWaitEvent (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Universal
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	PASSIVE_LEVEL
Regras de conformidade da DDI	Irql_Miscellaneous_Function(ndis)