Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
ASYNC_GETLINESTATUS (1.2)
◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
#define INCL_DOSDEVIOCTL
USHORT DosDevIOCtl(pbTransStatus, 0L, 0x0065, 0x0001, hDevice)
PBYTE pbTransStatus; /* pointer to variable for status */
HFILE hDevice; /* device handle */
The ASYNC_GETLINESTATUS function retrieves the data-transmission status for
the specified serial device.
Parameter Description
────────────────────────────────────────────────────────────────────────────
pbTransStatus Points to the variable that receives the data-transmission
status. This variable can be a combination of the following
values:
Value Meaning
─────────────────────────────────────────────────────────────
WRITE_REQUEST_QUEUED Write-request packets in progress or
queued.
DATA_IN_TX_QUE Data in the device-driver transmit
queue.
HARDWARE_TRANSMITTING Transmit hardware currently
transmitting data.
CHAR_READY_TO_SEND_IMM Character waiting to be transmitted
immediately.
WAITING_TO_SEND_XON Waiting to automatically transmit
XON.
WAITING_TO_SEND_XOFF Waiting to automatically transmit
XOFF.
hDevice Identifies the serial device that receives the device-control
function. The handle must have been created previously by
using the DosOpen function.
Return Value
The return value is zero if the function is successful or an error value if
an error occurs.
See Also
DosOpen, ASYNC_GETCOMMSTATUS
♦