Função SerCx2CustomReceiveTransactionNewDataNotification (sercx.h)

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

Retornar valor

Nenhum

Comentários

Se o FIFO de recebimento no controlador serial ficar vazio antes que uma transação de recebimento personalizado possa ser concluída, SerCx2 chamará a função de retorno de chamada de evento EvtSerCx2CustomReceiveTransactionEnableNewDataNotification , 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 leitura, 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 personalizado 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 tempos limite de intervalo, consulte SERIAL_TIMEOUTS. Para obter mais informações sobre notificações de novos dados, consulte SerCx2 Custom-Receive Transactions.