SsiQueryDeviceName

Function

Get the list of available devices.

Format

Ret = SsiQueryDeviceName ( Index , DeviceName , Device )

Parameters

Index [ C, C++: short ] [ Python: ctypes.c_short ]
This parameter should be zero for the first call and then be incremented for subsequent calls.

DeviceName [ C, C++: char * ] [ Python: ctypes.c_char_p ]
Return the device name. (For example: "SSI000")

Device [ C, C++: char * ] [ Python: ctypes.c_char_p ]
Return the board name. (For example: CPSN-SSI-4C)

Return Value

Ret [ C, C++: long ] [ Python: ctypes.c_long ]

Definition

Value

[Dec]

Description

SSI_ERR_SUCCESS

Succeeded

SSI_ERR_INFO_NOT_FIND_DEVICE

10051

Can not find device.

The others (See also: Details of Error Code)

Remarks

This function can be used when you create a general-purpose application that you can select a device you want to use.
The Index is set to zero for the first call. And then it should be incremented for subsequent calls until the function returns error.

Example

C, C++

long Ret;
char DeviceName[256];

char Device[256];
Ret = SsiQueryDeviceName(Index, DeviceName, Device);

Python

Ret = ctypes.c_long()
DeviceName = ctypes.create_string_buffer(256)

Device = ctypes.create_string_buffer(256)
Ret.value = cssi.SsiQueryDeviceName(Index, DeviceName, Device)