Função SerCx2SystemDmaReceiveNewDataNotification (sercx.h)

Artigo
02/27/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 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.