Função SerCx2CustomReceiveTransactionNewDataNotification (sercx.h)

Artigo
10/30/2024

O método SerCx2CustomReceiveTransactionNewDataNotification 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 SerCx2CustomReceiveTransactionNewDataNotification(
  [in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
);

Parâmetros

[in] CustomReceiveTransaction

Um identificador SERCX2CUSTOMRECEIVETRANSACTION para um objeto de recebimento personalizado. O driver do controlador serial anteriormente chamou o método SerCx2CustomReceiveTransactionCreate 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 personalizado possa ser concluída, o SerCx2 chamará a função de retorno de chamada de evento EvtSerCx2CustomReceiveTransactionEnableNewDataNotification função de retorno de chamada de evento, se ela for implementada, para permitir que uma notificação de novos dados ocorra quando novos dados estiverem disponíveis para serem lidos do FIFO de recebimento.

Se as notificações de novos dados estiverem habilitadas e novos dados estiverem disponíveis para serem lidos, o driver do controlador serial deverá chamar SerCx2CustomReceiveTransactionNewDataNotification para notificar o SerCx2. Essa notificação ocorre quando o driver detecta que um ou mais novos bytes de dados recebidos estão prontos para serem transferidos pelo mecanismo de transferência de dados personalizados ou já foram transferidos por esse mecanismo.

O driver do controlador serial deve chamar SerCx2CustomReceiveTransactionNewDataNotification apenas em resposta a uma chamada para a função EvtSerCx2CustomReceiveTransactionEnableNewDataNotification.

Se um driver de controlador serial der suporte a notificações de novos dados para transações de recebimento personalizado, 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 transações de Custom-Receive SerCx2.