CreateController

void ISystem.CreateController(string xml, string sn, uint id, SimulatorSettings settings)

Creates a simulated top-controller from an XML controller description provided as string.

Parameters

• xml – String containing XML controller description.

• sn – Serial number of the simulated top-controller.

• id – ID of the simulated top-controller, ignored if top-controller does not support an ID.

• settings – SimulatorSettings containing simulator configuration settings.

Throws

• InvalidArgumentException – Invalid client address specified, i.e. invalid IP address or hostname could not be resolved.

• InvalidArgumentException – Invalid CPU utilization specified in settings.

• InvalidArgumentException – Invalid number of real-time threads specified (zero).

• InvalidArgumentException – Out-of-range speed factor specified (<0.001 or> 1000).

• InvalidFormatException – Invalid XML contents (see exception message for details).

• InvalidConfigException – Simulator service cannot start/locate the simulator executable.

• OutOfResourcesException – Maximum number of top-controllers or pipes reached (limited by simulator service platform hardware resources).

• TimeoutException – Simulator service communication timeout.

• CommunicationErrorException – Protocol error.