Click or drag to resize

VideoConfigureDeviceProperties Method

Displays a device properties configuration dialog that allows the configuration of specialized settings.

Namespace:  ASCOM.DriverAccess
Assembly:  ASCOM.DriverAccess (in ASCOM.DriverAccess.dll) Version: 3c9121baba46811fe6e53a58a05935662261416d
public void ConfigureDeviceProperties()


NotConnectedExceptionMust throw an exception if the camera is not connected.
MethodNotImplementedExceptionMust throw an exception if the method is not supported.

The dialog could also provide buttons for cameras that can be controlled via 'on screen display' menues and a set of navigation buttons such as Up, Down, Left, Right and Enter. This dialog is not intended to be used in unattended mode but can give greater control over video cameras that provide special features. The dialog may also allow changing standard IVideo interface settings such as Gamma and Gain. If a client software displays any IVideo interface settings then it should take care to keep in sync the values changed by this method and those changed directly via the interface.

To support automated and unattended control over the specialized device settings or functions available on this dialog the driver should also allow their control via SupportedActions. This dialog is meant to be used by the applications to allow the user to adjust specialized device settings when those applications don't specifically use the specialized settings in their functionality.

Examples for specialized settings that could be supported are white balance and sharpness.

See Also