ASYNC STOPTRANSMIT: Difference between revisions
Created page with "This function behaves as if an XOFF was received (stops transmitting). ; Category:IOCTL_ASYNC (01h) ; Function:ASYNC_STOPTRANSMIT (47h) ==Parameter Packet Format== None. ..." |
mNo edit summary |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
This function behaves as if an XOFF was received (stops transmitting). | This function behaves as if an XOFF was received (stops transmitting). | ||
; Category:IOCTL_ASYNC (01h) | |||
; Category:IOCTL_ASYNC (01h) | ; Function:ASYNC_STOPTRANSMIT (47h) | ||
; Function:ASYNC_STOPTRANSMIT (47h) | |||
==Parameter Packet Format== | ==Parameter Packet Format== | ||
None. Packet pointer must be NULL. | None. Packet pointer must be NULL. | ||
==Data Packet Format== | ==Data Packet Format== | ||
None. Packet pointer must be NULL. | |||
None. Packet pointer must be NULL. | |||
==Returns== | ==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. | 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== | ==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 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 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. | 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. | See [[ASYNC_GETCOMMSTATUS]] for other reasons why transmission might be disabled. | ||
[[Category:IOCtl | [[Category:IOCtl Function]] | ||
{{DISPLAYTITLE:ASYNC_STOPTRANSMIT | {{DISPLAYTITLE:ASYNC_STOPTRANSMIT}} | ||
Latest revision as of 19:01, 22 October 2021
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.