Is_Getcameralist - THORLABS DCU223x Operation Manual And Sdk

4.3.35 is_GetCameraList

USB 2.0
USB 3.0
Syntax
INT is_GetCameraList (UC480_CAMERA_LIST* pucl)
Description
Using is_GetCameraList(), you can query information about the connected cameras. To get all information
that is available, you need to adjust the field size to the number of connected cameras. The following tables explain
the structures used for that purpose.
Input parameters
pucl
Contents of the UC480_CAMERA_LIST Structure
ULONG
UC480_CAMERA_INFO
Contents of the UC480_CAMERA_LIST::UC480_CAMERA_INFO Structure
DWORD
DWORD
DWORD
DWORD
Char
Char
DWORD
DWORD
Note
The serial number or model name should not be used to find a specific camera (e.g. in order to control this specific
camera). If you use the serial number, the software may not find the serial number after exchanging the camera.
The model name can be changed when updating the camera driver.
Instead, we recommend identifying a camera by a fixed camera ID, the camera type or by the sensor ID. The
advantage of the camera ID is that you can set it manually. That means if you exchange a camera, you can set the
same camera ID for the new camera.
Return values
IS_ACCESS_VIOLATION
IS_CANT_OPEN_DEVICE
IS_INVALID_PARAMETER
© 2013 Thorlabs GmbH
USB 2.0
USB 3.0
Handle to the UC480_CAMERA_LIST structure
dwCount
uci[1]
dwCameraID
dwDeviceID
dwSensorID
dwInUse
SerNo[16]
Model[16]
dwStatus
dwReserved[15]
Has to be initialized with the number of cameras
connected to the system.
This value can be read out with
is_GetNumberOfCameras()
Placeholder for 1 ... n UC480_CAMERA_INFO structures
Customizable camera ID. This ID is stored in the
camera and is persistent.
Internal device ID. This ID is generated by the driver
depending on order of connection and camera type. The
device ID is not persistent.
Sensor ID
1 = camera is being used.
0 = camera is not being used.
Serial number of the camera
Camera model
Information for the status of the camera
Reserved for later use
Not enough memory allocated for the
UC480_CAMERA_LIST structure
An attempt to initialize or select the camera failed (no
camera connected or initialization error).
One of the submitted parameters is outside the valid
range or is not supported for this sensor or is not
available in this mode.
4 Programming (SDK)
.
249
233