SerCx2PioTransmitReady function (sercx.h)

Article
10/21/2021

The SerCx2PioTransmitReady method notifies version 2 of the serial framework extension (SerCx2) that the transmit FIFO in the serial controller hardware is ready to accept more data.

Syntax

void SerCx2PioTransmitReady(
  [in] SERCX2PIOTRANSMIT PioTransmit
);

Parameters

[in] PioTransmit

A SERCX2PIOTRANSMIT handle to a PIO-transmit object. The serial controller driver previously called the SerCx2PioTransmitCreate method to create this object.

Return value

None

Remarks

To initiate a PIO-transmit transaction, SerCx2 calls the EvtSerCx2PioTransmitWriteBuffer event callback function and supplies a write buffer that contains the data to be transmitted. If the return value from this call indicates that the transmit FIFO in the serial controller became full before the entire contents of the write buffer could be transmitted, SerCx2 calls the EvtSerCx2PioTransmitEnableReadyNotification event callback function to enable a ready notification to occur when the FIFO is ready to accept more data.

If the ready notification is enabled, the serial controller driver must call SerCx2PioTransmitReady to notify SerCx2 after the transmit FIFO becomes ready to accept more data. In response to this notification, SerCx2 calls the EvtSerCx2PioTransmitWriteBuffer function again to transfer more data from the write buffer to the transmit FIFO.

The serial controller driver must call SerCx2PioTransmitReady only in response to a call to the EvtSerCx2PioTransmitEnableReadyNotification function.

For more information, see SerCx2 PIO-Transmit Transactions.

Requirements

Requirement	Value
Minimum supported client	Available starting with Windows 8.1.
Target Platform	Universal
Header	sercx.h
IRQL	<= DISPATCH_LEVEL

Share via