ioctl12.hlp (Topic list)
ASYNC_SETDCBINFO (1.2)
                                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSDEVIOCTL
 
USHORT DosDevIOCtl(0L, pusDCB, 0x0053, 0x0001, hDevice)
PUSHORT pusDCB;   /* pointer to structure with device-control information */
HFILE hDevice;    /* device handle                                        */
 
The ASYNC_SETDCBINFO function sets device-control block information.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
pusDCB     Points to the DCBINFO structure that receives the device-control
           block information.
 
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. When an error
occurs, the function returns an error value, and the device-control block
characteristics of the device driver for this serial device remain
unchanged.
 
Comments
 
A program can prevent making unwanted changes to device modes by calling the
ASYNC_GETDCBINFO function (0x0001,0x0073) to retrieve a copy of the current
DCB. The program can then modify only those fields it needs to and use the
modified DCB with the ASYNC_SETDCBINFO function.
 
See Also
 
DosOpen, ASYNC_GETDCBINFO, DCBINFO