GenSetDeviceName

Function

Set the device name.

Format

Ret = GenSetDeviceName ( AppId , DeviceName )

Parameters

AppId [ VB.NET: Short ] [ C++: short ] [ C#: short ]

Specify Application ID retrieved by GenOpenApplication.

DeviceName [ VB.NET: String] [ C++: char * ] [ C#: string]

Specify the device name.

Return Value

Ret [ VB.NET: Integer ] [ C++: long ] [ C#: int ]

Definition	Return Value	Description
GEN_ERR_SUCCESS	0	Normal completed
GEN_ERR_STARTED	10006	Cannot execute because the device is in operation.
GEN_ERR_DEVICENAME	10007	A device name isn't stored in DeviceName.

The others (See also: Error Code List)

Remarks

When setting the device name, please set a device that is supported by C-WaveformGenerator (with analog output function).
Use the specified function until you select another device or drop the application.
When changing from a device with 4 channels to a device with 2 channels, the number of channels becomes 2.
If the device is in operation, this function cannot be performed.

Example

Set the device name "AIO000".

VB.NET

Dim Ret As Integer

Ret = GenSetDeviceName(AppId, "AIO000")

C++

long Ret;

Ret = GenSetDeviceName(AppId, "AIO000");

int Ret;

Ret = gen.SetDeviceName(AppId, "AIO000");