ioctl12.hlp (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.
ASYNC_GETDCBINFO (1.2)
                                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSDEVIOCTL
 
USHORT DosDevIOCtl(pusDCB, 0L, 0x0073, 0x0001, hDevice)
PUSHORT pusDCB;    /* pointer to structure for device-control information */
HFILE hDevice;     /* device handle                                       */
 
The ASYNC_GETDCBINFO function retrieves 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 any data copied to the
DCBINFO structure pointed to by the pusDCB parameter is not valid.
 
Comments
 
To ensure that only valid values are set in the device-control block, the
program should call the ASYNC_GETDCBINFO function to fill the block, and
then modify the settings and call the ASYNC_SETDCBINFO function with the
modified block.
 
See Also
 
DosOpen, ASYNC_SETDCBINFO, DCBINFO