Função SerCx2SystemDmaReceiveNewDataNotification (sercx.h)
O método SerCx2SystemDmaReceiveNewDataNotification notifica a versão 2 da extensão da estrutura serial (SerCx2) de que os dados estão disponíveis para serem lidos do FIFO de recebimento no hardware do controlador serial.
Sintaxe
void SerCx2SystemDmaReceiveNewDataNotification(
[in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
);
Parâmetros
[in] SystemDmaReceive
Um identificador SERCX2SYSTEMDMARECEIVE para um objeto system-DMA-receive. O driver do controlador serial anteriormente chamou o método SerCx2SystemDmaReceiveCreate para criar esse objeto.
Retornar valor
Nenhum
Comentários
Se o FIFO de recebimento no controlador serial ficar vazio antes que uma transação system-DMA-receive possa ser concluída, SerCx2 chamará a função de retorno de chamada de evento EvtSerCx2SystemDmaReceiveEnableNewDataNotification , se ela for implementada, para permitir que o SerCx2 receba uma notificação de novos dados quando os dados estiverem novamente disponíveis para serem lidos do FIFO de recebimento.
Se a notificação de novos dados estiver habilitada, o driver do controlador serial deverá chamar SerCx2SystemDmaReceiveNewDataNotification para notificar o SerCx2 depois que o controlador serial receber novos dados. Uma notificação ocorre quando o driver detecta que um ou mais novos bytes de dados recebidos estão prontos para serem transferidos ou já foram transferidos pelo controlador de DMA do sistema.
O controlador serial deve chamar SerCx2SystemDmaReceiveNewDataNotification apenas em resposta a uma chamada para a função EvtSerCx2SystemDmaReceiveEnableNewDataNotification .
Se um driver de controlador serial der suporte a notificações de novos dados para transações de recebimento de DMA do sistema, o SerCx usará essas notificações para detectar tempos limite de intervalo durante o tratamento de solicitações de leitura (IRP_MJ_READ). Para obter mais informações sobre tempos limite de intervalo, consulte SERIAL_TIMEOUTS. Para obter mais informações sobre notificações de novos dados, consulte Transações serCx2 System-DMA-Receive.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível a partir do Windows 8.1. |
Plataforma de Destino | Universal |
Cabeçalho | sercx.h |
IRQL | <= DISPATCH_LEVEL |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de