Funzione SerCx2PioTransmitPurgeFifoComplete (sercx.h)

Il metodo SerCx2PioTransmitPurgeFifoComplete notifica la 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 in precedenza denominato 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 funzione di callback dell'evento EvtSerCx2PioTransmitPurgeFifo , 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 il timeout della richiesta di scrittura. Per altre informazioni, vedere Gestione serCx2 delle richieste di lettura e scrittura.

In risposta alla chiamata di funzione EvtSerCx2PioTransmitPurgeFifo , il driver elimina prima tutti i dati che rimangono nella trasmissione FIFO; quindi il driver deve chiamare SerCx2PioTransmitPurgeFifoComplete per notificare SerCx2. SerCx2 prevede questa notifica e non completa la richiesta di scrittura finché non viene notificata.

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

SerCx2 usa il valore del parametro BytesPurged per determinare il numero di byte trasmessi correttamente prima che la trasmissione FIFO sia stata eliminata. SerCx2 richiede che queste informazioni completino una richiesta di scrittura che viene interrotta o una richiesta di scrittura annullata dopo la trasmissione di uno o più byte.

Per altre informazioni, vedere SerCx2 PIO-Transmit Transazioni.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.1.
Piattaforma di destinazione	Universale
Intestazione	sercx.h
IRQL	<= DISPATCH_LEVEL

Vedi anche

EvtSerCx2PioTransmitPurgeFifo

IRP_MJ_WRITE

SERCX2PIOTRANSMIT

SERIAL_TIMEOUTS

SerCx2PioTransmitCreate