PlatformUtilitiesCreateDynamicDriver Method

Create an Alpaca Dynamic Driver to present an Alpaca device as a COM device. (Platform 6.5 or later)

Definition

Namespace: ASCOM.Com
Assembly: ASCOM.Com (in ASCOM.Com.dll) Version: 3.0.0-rc.1+86c25ce733aebb4d8b1b8a62e84770ea5e972bea
C#
public static string CreateDynamicDriver(
	DeviceTypes deviceType,
	int deviceNumber,
	string description,
	string hostName,
	int ipPort,
	string deviceUniqueId
)

Parameters

deviceType  DeviceTypes
ASCOM device type
deviceNumber  Int32
ALpaca device number of this device
description  String
Text description of the Alpaca device that will appear in the Chooser.
hostName  String
Host-name or IP address of the Alpaca device
ipPort  Int32
IP port of the Alpaca device
deviceUniqueId  String
The Alpaca device's unique ID.

Return Value

String
The COM ProgID of the created dynamic driver.

Remarks

The Dynamic driver functionality was introduced in Platform 6.5, consequently, this method will throw an InvalidOperationException if invoked on previous platforms.

Microsoft security requires that the user provides Administrator level access in order to create and register the dynamic driver. The Platform's Dynamic Client Manager will trigger the UAC request process automatically and will, or will not, run depending on whether permission is granted. As an application developer, you are not directly involved in this automatic process. However, you should make your customers aware that the security dialogue will appear when creating the driver, and check that the modal UAC dialogue does not disrupt your application or UI while displayed. ///

Exceptions

InvalidOperationExceptionIf the installed Platform version is earlier that 6.5.
InvalidValueExceptionWhen supplied parameters are outside valid ranges.

Version Information

.NET Standard

Supported in: 2.0

See Also