Função SerCx2PioTransmitPurgeFifoComplete (sercx.h)

Artigo
02/29/2024

O método SerCx2PioTransmitPurgeFifoComplete notifica a versão 2 da extensão da estrutura serial (SerCx2) de que o driver do controlador serial concluiu a limpeza dos dados do FIFO de transmissão no hardware do controlador serial.

Sintaxe

void SerCx2PioTransmitPurgeFifoComplete(
  [in] SERCX2PIOTRANSMIT PioTransmit,
  [in] ULONG             BytesPurged
);

Parâmetros

[in] PioTransmit

Um identificador SERCX2PIOTRANSMIT para um objeto de transmissão DE PIO. O driver do controlador serial anteriormente chamou o método SerCx2PioTransmitCreate para criar esse objeto.

[in] BytesPurged

O número de bytes de dados não recuos que o driver do controlador serial limpou do FIFO de transmissão.

Retornar valor

Nenhum

Comentários

SerCx2 chama a função de retorno de chamada de evento EvtSerCx2PioTransmitPurgeFifo , se ela for implementada, para encerrar a transação de transmissão de PIO atual. O SerCx2 iniciou essa transação anteriormente em resposta a uma solicitação de gravação (IRP_MJ_WRITE) de um cliente. Por exemplo, SerCx2 pode chamar essa função se o cliente cancelar a solicitação de gravação pendente ou a solicitação de gravação atingir o tempo limite. Para obter mais informações, consulte Tratamento serCx2 de solicitações de leitura e gravação.

Em resposta à chamada da função EvtSerCx2PioTransmitPurgeFifo , o driver primeiro descarta todos os dados que permanecem no FIFO de transmissão; em seguida, o driver deve chamar SerCx2PioTransmitPurgeFifoComplete para notificar o SerCx2. O SerCx2 espera essa notificação e não conclui a solicitação de gravação até que ela seja notificada.

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

SerCx2 usa o valor do parâmetro BytesPurged para determinar quantos bytes foram transmitidos com êxito antes da limpeza do FIFO de transmissão. O SerCx2 exige que essas informações concluam uma solicitação de gravação que atinge o tempo limite ou uma solicitação de gravação cancelada depois que um ou mais bytes são transmitidos.

Para obter mais informações, consulte SerCx2 PIO-Transmit Transactions.