bool GetSwitch(
short id
)Function GetSwitch (
id As Short
) As BooleanMust be implemented, must not throw a NotImplementedException.
All devices must implement this. A multi-state device will return true if the device is at the maximum value, false if the value is at the minimum and either true or false as specified by the driver developer for intermediate values.
Some devices do not support reading their state although they do allow state to be set. In these cases, on start-up, the driver can not know the hardware state and it is recommended that the driver either:
In both cases the driver should save a local copy of the state which it last set and return this through GetSwitch(Int16) and GetSwitchValue(Int16)
Devices are numbered from 0 to MaxSwitch - 1
| InvalidOperationException | If there is a temporary condition that prevents the device value being returned. |
| InvalidValueException | If id is outside the range 0 to MaxSwitch - 1 |
| NotConnectedException | When Connected is False. |
| DriverException | An 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. |