ASYNC STOPTRANSMIT
This function behaves as if an XOFF was received (stops transmitting).
- Category
- IOCTL_ASYNC (01h)
- Function
- ASYNC_STOPTRANSMIT (47h)
Parameter Packet Format
None. Packet pointer must be NULL.
Data Packet Format
None. Packet pointer must be NULL.
Returns
If the call is made with invalid Parameter Packet or Data Packet pointers, a general failure error is reported, and this request is not performed by the physical device driver.
Remarks
If a general failure error is not returned by the physical device driver, this function causes data transmission to be stopped by preventing the physical device driver from sending additional data to the transmit hardware.
If Automatic Transmit Flow Control is enabled, this request causes the physical device driver to behave as if it had received the XOFF character. Transmission can be resumed when an XON is received by the physical device driver after a ASYNC_STARTTRANSMIT request is received, or when the physical device driver is told to disable Automatic Transmit Flow Control (if it was enabled).
If Automatic Transmit Flow Control is disabled, then the Function 48h request is required for transmission to be resumed. If, after this request is received, the physical device driver is told to enable Automatic Transmit Flow Control, then transmission is still disabled, but can be re-enabled. See Note 2 of ASYNC_SETDCBINFO.
See ASYNC_GETCOMMSTATUS for other reasons why transmission might be disabled.