Função SerCx2PioReceiveReady (sercx.h)

Artigo
10/30/2024

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 de SERCX2PIORECEIVE para um objeto de recebimento de PIO. O driver do controlador serial anteriormente chamou o método SerCx2PioReceiveCreate para criar esse objeto.

Valor de retorno

Nenhum

Observações

Para iniciar uma transação de recebimento de PIO, o SerCx2 chama o EvtSerCx2PioReceiveReadBuffer função de retorno de chamada de evento 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 de o FIFO de recebimento ficar vazio, o SerCx2 chamará o EvtSerCx2PioReceiveEnableReadyNotification rotina de retorno de chamada de evento 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, 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 apenas 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 intervalos de tempo limite, consulte SERIAL_TIMEOUTS. Para obter mais informações sobre notificações prontas, consulte transações de PIO-Receive SerCx2.