msos2.hlp (Table of Contents; Topic list)
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.
DCBINFO (1.2)
                                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSDEVIOCTL
 
typedef struct _DCBINFO {    /* dcbinf */
    USHORT usWriteTimeout;
    USHORT usReadTimeout;
    BYTE   fbCtlHndShake;
    BYTE   fbFlowReplace;
    BYTE   fbTimeout;
    BYTE   bErrorReplacementChar;
    BYTE   bBreakReplacementChar;
    BYTE   bXONChar;
    BYTE   bXOFFChar;
} DCBINFO;
 
The DCBINFO structure holds device-control block information.
 
Field                  Description
────────────────────────────────────────────────────────────────────────────
 
usWriteTimeout         Specifies the time-out in one-hundredths of a second.
                       If set to zero, the time-out is 0.01 seconds; if set
                       to 1, the time-out is 0.02 seconds, and so on.
 
usReadTimeout          Specifies the time-out in one-hundredths of a second.
                       If set to zero, the time-out is 0.01 seconds; if set
                       to 1, the time-out is 0.02 seconds, and so on.
 
fbCtlHndShake          Specifies the control and handshaking modes for the
                       DTR and other signals. It can be a combination of the
                       following values:
 
                       Value                 Meaning
                       ─────────────────────────────────────────────────────
                       MODE_DTR_CONTROL      Enable the data-terminal-ready
                                             (DTR) control mode.
 
                       MODE_DTR_HANDSHAKE    Enable the data-terminal-ready
                                             (DTR) input handshaking mode.
 
                       MODE_CTS_HANDSHAKE    Enable output handshaking using
                                             the clear-to-send (CTS)
                                             signal.
 
                       MODE_DSR_HANDSHAKE    Enable output handshaking using
                                             the data-set-ready (DSR)
                                             signal.
 
                       MODE_DCD_HANDSHAKE    Enable output handshaking using
                                             the data-carrier-detect (DCD)
                                             signal.
 
                       MODE_DSR_SENSITIVITY  Enable input sensitivity using
                                             the data-set-ready (DSR)
                                             signal.
 
fbFlowReplace          Specifies the flow control and replacement character
                       modes. It can be a combination of the following
                       values:
 
                       Value                 Meaning
                       ─────────────────────────────────────────────────────
                       MODE_AUTO_TRANSMIT    Enable automatic transmit flow
                                             control (XON/XOFF).
 
                       MODE_AUTO_RECEIVE     Enable automatic receive flow
                                             control (XON/XOFF).
 
                       MODE_ERROR_CHAR       Enable error replacement
                                             character.
 
                       MODE_NULL_STRIPPING   Enable null stripping (remove
                                             null bytes).
 
                       MODE_BREAK_CHAR       Enable break replacement
                                             character.
 
                       MODE_RTS_CONTROL      Enable the request-to-send
                                             (RTS) control mode.
 
                       MODE_RTS_HANDSHAKE    Enable the request-to-send
                                             (RTS) input handshaking mode.
 
                       MODE_TRANSMIT_TOGGLE  Enable toggling on transmit
                                             mode.
 
fbTimeout              Specifies the time-out processing for the device. It
                       can be a combination of the following values:
 
                       Value                     Meaning
                       ─────────────────────────────────────────────────────
                       MODE_NO_WRITE_TIMEOUT     Enable write infinite
                                                 time-out processing.
 
                       MODE_READ_TIMEOUT         Enable normal read time-out
                                                 processing.
 
                       MODE_WAIT_READ_TIMEOUT    Enable wait-for-something
                                                 read time-out processing.
 
                       MODE_NOWAIT_READ_TIMEOUT  Enable no-wait read
                                                 time-out processing.
 
bErrorReplacementChar  Specifies the error replacement character.
 
bBreakReplacementChar  Specifies the break replacement character.
 
bXONChar               Specifies the transmission on (XON) character.
 
bXOFFChar              Specifies the transmission off (XOFF) character.
 
See Also
 
ASYNC_GETDCBINFO, ASYNC_SETDCBINFO