Funzione SerCx2SystemDmaTransmitDrainFifoComplete (sercx.h)

Articolo
10/30/2024

Il metodo SerCx2SystemDmaTransmitDrainFifoComplete notifica alla versione 2 dell'estensione del framework seriale (SerCx2) che il driver del controller seriale ha terminato di svuotare i dati dalla trasmissione FIFO nell'hardware del controller seriale.

Sintassi

void SerCx2SystemDmaTransmitDrainFifoComplete(
  SERCX2SYSTEMDMATRANSMIT SystemDmaTransmit
);

Parametri

SystemDmaTransmit

Handle SERCX2SYSTEMDMATRANSMIT a un oggetto di trasmissione PIO. Il driver del controller seriale precedentemente denominato metodo SerCx2SystemDmaTransmitCreate per creare questo oggetto.

Valore restituito

Nessuno

Osservazioni

SerCx2 chiama il EvtSerCx2SystemDmaTransmitDrainFifo funzione di callback degli eventi, se implementata, per svuotare la trasmissione FIFO alla fine di una transazione di trasmissione DMA di sistema. Questa funzione assicura che tutti i byte di dati che rimangono nella porta FIFO vengano trasmessi dalla porta seriale prima che SerCx2 completi la richiesta di scrittura (IRP_MJ_WRITE) che ha avviato la transazione. Dopo la trasmissione dell'ultimo byte dal FIFO, il driver del controller seriale deve chiamare il metodo SerCx2SystemDmaTransmitDrainFifoComplete per notificare a SerCx2. SerCx2 prevede questa notifica e non completa la richiesta di scrittura fino a quando non viene inviata una notifica.

Il controller seriale deve chiamare SerCx2SystemDmaTransmitDrainFifoComplete solo in risposta a una chiamata alla funzione EvtSerCx2SystemDmaTransmitDrainFifo.

Per altre informazioni, vedere SerCx2 System-DMA-Transmit Transactions.