CreateControllerFromFile

virtual void IBus::CreateControllerFromFile(const std::string &filename, const SSimulatedControllerProperties &properties) = 0

Creates a simulated sub-controller from an XML controller description stored in file. The created sub-controller is a child of the parent controller of this bus and is connected to this bus.

Parameters

• filename – Name of file containing XML controller description.

• properties – SimulatedControllerProperties containing properties of the controller.

Throws

• CInvalidArgumentException – Empty serial number specified.

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

• CUnsupportedException – Bus is not part of a simulated top-controller.

• COutOfResourcesException – Maximum number of controllers reached (limited by simulator service platform hardware resources).

• CAccessDeniedException – Unable to open file for reading.

• CReadErrorException – Error while reading from the specified file.

• CCommunicationErrorException – Protocol error.

• CConnectionLostException – Connection to controller lost.

• CRebootedException – Controller has been rebooted since this object reference was retrieved, invalidating this reference.

• CIncompatibleException – Incompatible firmware version loaded.

• CObjectDestroyedException – Object is destroyed.