C++ SDK

◆ ChangeApplicationOptions()

static int CApplicationAPI::ChangeApplicationOptions ( LpError  lpError,
SChangeOption lpChangeOption,
DWORD  dwMaxTime = DEFAULT_MAX_TIME 
)
static

The function changes basic Drive settings.

Parameters
lpErrorAdditional error information returned from Drive.
lpChangeOptionReference to instance of SChangeOption type which contains new Drive settings.
dwMaxTimeMaximum time (in milliseconds) function can take. If dwMaxTime=0 function execution is not time limited.
Returns
1 if successful, other value otherwise.

Use ChangeOption to set new Drive settings. It is possible to change these characteristics:

  • appearance for right or left handed user
  • enable/disable sounds
  • set maximum and minimum sound volume Sound volume is changed with changing of velocity. Maximum value is used with high speed and minimum with low speed.
  • set clock format. It is possible to choose EUROPE, UK or US format.
  • set distance units. User can choose kilometers or miles.
  • set GPS units. User can choose degrees, minutes or seconds.
  • set location of home position.
  • set keyboard type which Drive uses. After function execution ChangeOption contains actual Drive settings.

    Possible error codes returned from Drive are:
  • 0 - Function not succeeded.
  • 1 - Function succeeded.
  • 2 - Drive not succeeded.
  • 3 - Function reached timeout.