110
BuildCommDCB
int BuildCommDCB(lpszDef, lpdcb)
LPCSTR lpszDef;
/* Address of the device control character string */
DCB FAR *lpdcb;
/* Address of the device control block */
The BuildCommDCB function converts the device definition character string to the corresponding
serial device control block (DCB) codes.
< Parameter >
lpszDef
: Pointer to a character string that specifies the device control information and ends with a
NULL character. This character string must have the same format as the parameters used
for MS-DOS commands.
lpdcb
: Pointer to the DCB structure that receives the converted character string. This structure
defines the control setups to be sent to the serial communication device.
< Return value >
Returns zero if the function is terminated normally. Otherwise it returns -1.
Note:
The BuildCommDCB function simply stores a value in the buffer. The application program side
should set the value on the port using the SetCommState function. By default this BuildCommDCB
function is set so that XON/XOFF and hardware flow controls are disabled. To enable these flow
controls use the application to make the appropriate setting in the DCB structure.
Note on IrDA:
No special restriction on use of the function.
