Função SerCx2SystemDmaTransmitPurgeFifoComplete (sercx.h)

Artigo
10/30/2024

O método SerCx2SystemDmaTransmitPurgeFifoComplete notifica a versão 2 da extensão da estrutura serial (SerCx2) de que o driver do controlador serial terminou de limpar os dados do FIFO de transmissão no hardware do controlador serial.

Sintaxe

void SerCx2SystemDmaTransmitPurgeFifoComplete(
  [in] SERCX2SYSTEMDMATRANSMIT SystemDmaTransmit,
  [in] ULONG                   BytesPurged
);

Parâmetros

[in] SystemDmaTransmit

Um identificador SERCX2SYSTEMDMATRANSMIT para um objeto de transmissão de DMA do sistema. O driver do controlador serial anteriormente chamou o método SerCx2SystemDmaTransmitCreate para criar esse objeto.

[in] BytesPurged

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

Valor de retorno

Nenhum

Observações

O SerCx2 chama a função de retorno de chamada de evento EvtSerCx2SystemDmaTransmitPurgeFifo, se ela for implementada, para informar ao driver do controlador serial para encerrar a transação atual de transmissão de DMA do sistema. 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 poderá chamar essa função se o cliente cancelar a solicitação de gravação pendente ou se 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 EvtSerCx2SystemDmaTransmitPurgeFifo, o driver interrompe a transferência de dados do buffer de gravação para o FIFO de transmissão e descarta todos os dados transferidos anteriormente que permanecem no FIFO de transmissão. Após a conclusão da limpeza, o driver do controlador serial deve chamar SerCx2SystemDmaTransmitPurgeFifoComplete 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 SerCx2SystemDmaTransmitPurgeFifoComplete apenas em resposta a uma chamada para a função EvtSerCx2SystemDmaTransmitPurgeFifo.

O 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 requer que essas informações preencham 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 de TransaçõesDMA-Transmit do Sistema SerCx2.