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.

110

Page 110
Image 110
Casio IT-2000W manual BuildCommDCB, Parameter, Return value