Funzione SerCx2PioTransmitPurgeFifoComplete (sercx.h)

Articolo
10/30/2024

Il metodo SerCx2PioTransmitPurgeFifoComplete notifica alla versione 2 dell'estensione del framework seriale (SerCx2) che il driver del controller seriale ha completato l'eliminazione dei dati dalla trasmissione FIFO nell'hardware del controller seriale.

Sintassi

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

Parametri

[in] PioTransmit

Handle SERCX2PIOTRANSMIT a un oggetto di trasmissione PIO. Il driver del controller seriale precedentemente chiamato il metodo SerCx2PioTransmitCreate per creare questo oggetto.

[in] BytesPurged

Numero di byte di dati non inviati eliminati dal driver del controller seriale dalla trasmissione FIFO.

Valore restituito

Nessuno

Osservazioni

SerCx2 chiama la EvtSerCx2PioTransmitPurgeFifo funzione di callback degli eventi, se implementata, per terminare la transazione di trasmissione PIO corrente. SerCx2 ha avviato in precedenza questa transazione in risposta a una richiesta di scrittura (IRP_MJ_WRITE) da un client. Ad esempio, SerCx2 potrebbe chiamare questa funzione se il client annulla la richiesta di scrittura in sospeso o si verifica il timeout della richiesta di scrittura. Per altre informazioni, vedere SerCx2 Handling of Read and Write Requests.

In risposta al EvtSerCx2PioTransmitPurgeFifo chiamata di funzione, il driver rimuove prima di tutto tutti i dati che rimangono nel FIFO di trasmissione; il driver deve quindi chiamare SerCx2PioTransmitPurgeFifoComplete per notificare a SerCx2. SerCx2 prevede questa notifica e non completa la richiesta di scrittura fino a quando non viene inviata una notifica.

Il driver del controller seriale deve chiamare SerCx2PioTransmitPurgeFifoComplete solo in risposta a una chiamata alla funzione EvtSerCx2PioTransmitPurgeFifo.

SerCx2 usa il valore del parametro bytepurged per determinare il numero di byte trasmessi correttamente prima che la trasmissione FIFO sia stata ripulita. SerCx2 richiede che queste informazioni completino una richiesta di scrittura che si verifica il timeout o una richiesta di scrittura annullata dopo la trasmissione di uno o più byte.

Per altre informazioni, vedere SerCx2 PIO-Transmit Transactions.