BuildCommunicationsDataControlBlock


static void BuildCommunicationsDataControlBlock(String^ Control,
                                                Handle ControlBlock)

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

Parameters

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.

Notes

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.

Details

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