Função SerCx2SystemDmaReceiveNewDataNotification (sercx.h)

Artigo
10/30/2024

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 de SERCX2SYSTEMDMARECEIVE para um objeto de recebimento de DMA do sistema. O driver do controlador serial anteriormente chamou o método SerCx2SystemDmaReceiveCreate para criar esse objeto.

Valor de retorno

Nenhum

Observações

Se o FIFO de recebimento no controlador serial ficar vazio antes que uma transação de recebimento de DMA do sistema possa ser concluída, o SerCx2 chamará o EvtSerCx2SystemDmaReceiveEnableNewDataNotification função de retorno de chamada de evento, 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 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 intervalos de tempo limite, consulte SERIAL_TIMEOUTS. Para obter mais informações sobre notificações de novos dados, consulte de Transações do Sistema SerCx2DMA-Receive.