static void BuildCommunicationsDataControlBlock(String^ Control,
                                                Handle ControlBlock)

This function builds a data control block from a device control string.


String^ Control

A pointer to a string containing device control information. The string must have the same format as the parameters of the command processor "MODE". For example, the following string specifies a baud rate of 1200, no parity, 8 data bits and 1 stop bit:

baud=1200 parity=N data=8 stop=1 

When the device name is included in the string it must specify a valid device but it is otherwise ignored. An example is shown below.

COM1: baud=1200 parity=N data=8 stop=1
Handle ControlBlock

A pointer to an object that receives the converted information.


Only those members of the DCB structure that are specifically affected by the parameter control are updated, with the following exceptions:

  1. If a baud rate of 110 is specified, stop bits is set to 2 and
  2. XON/XOFF and hardware flow control are disabled.

To enable flow control, the appropriate members of the object must be explicitly set.

To apply the data control block settings to a serial port, the function SetCommunicationsState may be used.


Name Space IPlusPlus::Control
Class Base
Assembly IPlusPlus.WinPlus.dll