Función SerCx2PioTransmitPurgeFifoComplete (sercx.h)
El método SerCx2PioTransmitPurgeFifoComplete notifica a la versión 2 de la extensión de marco serie (SerCx2) que el controlador del controlador serie ha terminado de purgar los datos de la transmisión fiFO en el hardware del controlador serie.
Sintaxis
void SerCx2PioTransmitPurgeFifoComplete(
[in] SERCX2PIOTRANSMIT PioTransmit,
[in] ULONG BytesPurged
);
Parámetros
[in] PioTransmit
Identificador de SERCX2PIOTRANSMIT a un objeto PIO-transmit. El controlador de controlador serie llamó anteriormente al método SerCx2PioTransmitCreate para crear este objeto.
[in] BytesPurged
Número de bytes de datos sin enviar que el controlador del controlador serie purgó de la transmisión FIFO.
Valor devuelto
Ninguno
Observaciones
SerCx2 llama a la EvtSerCx2PioTransmitPurgeFifo función de devolución de llamada de eventos, si se implementa, para finalizar la transacción de transmisión de PIO actual. SerCx2 inició previamente esta transacción en respuesta a una solicitud de escritura (IRP_MJ_WRITE) de un cliente. Por ejemplo, SerCx2 podría llamar a esta función si el cliente cancela la solicitud de escritura pendiente o se agota el tiempo de espera de la solicitud de escritura. Para obtener más información, vea control de SerCx2 de solicitudes de lectura y escritura.
En respuesta a la llamada de función EvtSerCx2PioTransmitPurgeFifo, el controlador descarta primero los datos que permanecen en la transmisión de FIFO; a continuación, el controlador debe llamar a SerCx2PioTransmitPurgeFifoComplete para notificar a SerCx2. SerCx2 espera esta notificación y no completa la solicitud de escritura hasta que se le notifique.
El controlador de controlador serie debe llamar a serCx2PioTransmitPurgeFifoComplete solo en respuesta a una llamada a la función EvtSerCx2PioTransmitPurgeFifo.
SerCx2 usa el valor de parámetro de BytesPurged para determinar cuántos bytes se transmitieron correctamente antes de purgar fiFO de transmisión. SerCx2 requiere que esta información complete una solicitud de escritura que agote el tiempo de espera o una solicitud de escritura que se cancele después de que se transmitan uno o varios bytes.
Para obtener más información, vea SerCx2 PIO-Transmit Transactions.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 8.1. |
| de la plataforma de destino de |
Universal |
| encabezado de |
sercx.h |
| irQL | <= DISPATCH_LEVEL |