AscomDriverDeviceState Property

Returns the device's operational state in a single call.

Namespace: ASCOM.DriverAccess
Assembly: ASCOM.DriverAccess (in ASCOM.DriverAccess.dll) Version: 7.0.0-rc.0+0

Syntax

public IStateValueCollection DeviceState { get; }

Public ReadOnly Property DeviceState As IStateValueCollection
	Get

public:
virtual property IStateValueCollection^ DeviceState {
	IStateValueCollection^ get () sealed;
}

Property Value

IStateValueCollection

Exceptions

Exception	Condition
NotConnectedException	If the device is not connected
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.

Remarks

This is a mandatory property and must not throw a PropertyNotImplementedException.

Devices

Devices must return all operational values that are definitively known but can omit entries where values are unknown. Devices must not throw exceptions / return errors when values are not known.

An empty list must be returned if no values are known.

Client Applications

Applications must expect that, from time to time, some operational state values may not be present in the device response and must be prepared to handle “missing” values.

Further Information

See Device State Implementation and Requirements for further information on how to implement DeviceState, which properties to include, and the implementation support provided by the Platform.

Reference

AscomDriver Class

ASCOM.DriverAccess Namespace

Other Resources

Device State Implementation and Requirements