Função SerCx2PioReceiveReady (sercx.h)

Artigo
08/07/2023

O método SerCx2PioReceiveReady 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 controlador serial.

Sintaxe

void SerCx2PioReceiveReady(
  [in] SERCX2PIORECEIVE PioReceive
);

Parâmetros

[in] PioReceive

Um identificador SERCX2PIORECEIVE para um objeto de recebimento de PIO. O driver do controlador serial anteriormente chamou o método SerCx2PioReceiveCreate para criar esse objeto.

Retornar valor

Nenhum

Comentários

Para iniciar uma transação de recebimento de PIO, o SerCx2 chama a função de retorno de chamada de evento EvtSerCx2PioReceiveReadBuffer e fornece um buffer de leitura para o qual transferir os dados do FIFO de recebimento no controlador serial. Se o valor retornado dessa função indicar que o buffer de leitura só foi parcialmente preenchido antes do FIFO de recebimento ficar vazio, SerCx2 chamará a rotina de retorno de chamada de evento EvtSerCx2PioReceiveEnableReadyNotification para permitir que uma notificação pronta ocorra quando mais dados estiverem disponíveis para leitura.

Se a notificação pronta estiver habilitada e mais dados estiverem disponíveis para leitura, o driver do controlador serial deverá chamar SerCx2PioReceiveReady para notificar o SerCx2. Em resposta a essa notificação, SerCx2 chama a função EvtSerCx2PioReceiveReadBuffer novamente para transferir mais dados do FIFO de recebimento para o buffer de leitura.

O driver do controlador serial deve chamar SerCx2PioReceiveReady somente em resposta a uma chamada para a função EvtSerCx2PioReceiveEnableReadyNotification .

Além disso, o SerCx2 usa essas notificações prontas para detectar tempos limite de intervalo durante o tratamento de uma solicitação de leitura. Para obter mais informações sobre tempos limite de intervalo, consulte SERIAL_TIMEOUTS. Para obter mais informações sobre notificações prontas, consulte SerCx2 PIO-Receive Transactions.