Función SerCx2PioTransmitPurgeFifoComplete (sercx.h)

Artículo
03/05/2024

El método SerCx2PioTransmitPurgeFifoComplete notifica a la versión 2 de la extensión del marco de trabajo serie (SerCx2) que el controlador del controlador serie ha terminado de purgar los datos de la transmisión de FIFO en el hardware del controlador serie.

Sintaxis

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

Parámetros

[in] PioTransmit

Identificador SERCX2PIOTRANSMIT para un objeto pio-transmit. El controlador de serie llamó anteriormente al método SerCx2PioTransmitCreate para crear este objeto.

[in] BytesPurged

Número de bytes de datos sin enviar que el controlador de controlador serie purgó del FIFO de transmisión.

Valor devuelto

None

Observaciones

SerCx2 llama a la función de devolución de llamada de eventos EvtSerCx2PioTransmitPurgeFifo , 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 la solicitud de escritura agota el tiempo de espera. Para obtener más información, consulte Control de serCx2 de solicitudes de lectura y escritura.

En respuesta a la llamada a la función EvtSerCx2PioTransmitPurgeFifo , el controlador descarta primero los datos que permanecen en el FIFO de transmisión; 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 del parámetro 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, consulte SerCx2 PIO-Transmit Transactions.