Click or drag to resize

VideoConfigureDeviceProperties Method

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

Namespace:  ASCOM.DriverAccess
Assembly:  ASCOM.DriverAccess (in ASCOM.DriverAccess.dll) Version: 3351c4f3fa64146a7efd5b51ed4591e32a0a5484
Syntax
public void ConfigureDeviceProperties()

Implements

IVideoConfigureDeviceProperties
Exceptions
ExceptionCondition
MethodNotImplementedExceptionMust throw an exception if the method is not supported.
NotConnectedExceptionIf the device is not connected
DriverExceptionAn error occurred that is not described by one of the more specific ASCOM exceptions. The device did not successfully complete the request.
Remarks

The dialogue could also provide buttons for cameras that can be controlled via 'on screen display' menus and a set of navigation buttons such as Up, Down, Left, Right and Enter. This dialogue is not intended to be used in unattended mode but can give greater control over video cameras that provide special features. The dialogue 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 dialogue the driver should also allow their control via SupportedActions. This dialogue 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