Click or drag to resize

IVideoConfigureDeviceProperties Method

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

Namespace:  ASCOM.DeviceInterface
Assembly:  ASCOM.DeviceInterfaces (in ASCOM.DeviceInterfaces.dll) Version: 3351c4f3fa64146a7efd5b51ed4591e32a0a5484
Syntax
Copy
void ConfigureDeviceProperties()
Exceptions
ExceptionCondition
MethodNotImplementedExceptionMust throw an exception if not implemented.
NotConnectedExceptionIf the device is not connected
DriverExceptionAn error occurred that is not described by one of the more specific ASCOM exceptions. Include sufficient detail in the message text to enable the issue to be accurately diagnosed by someone other than yourself.
Remarks

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