Home > C: Programming > Function Descriptions > History back  Previous chapter  Next chapter  Print  

is_GetCameraList

uEye Camera Manual Version 3.80

is_GetCameraList

Windows_Logo

Linux_Logo

USB 2.0

GigE

USB 2.0

GigE

Syntax

INT is_GetCameraList (UEYE_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

Handle to the UEYE_CAMERA_LIST structure

Contents of the UEYE_CAMERA_LIST Structure

ULONG

dwCount

Has to be initialized with the number of cameras connected to the system.

This value can be read out with is_GetNumberOfCameras().

UEYE_CAMERA_INFO

uci[1]

Placeholder for 1 .. n UEYE_CAMERA_INFO structures

Contents of the UEYE_CAMERA_LIST::UEYE_CAMERA_INFO Structure

DWORD

dwCameraID

Customisable camera ID. This ID is stored in the camera and is persistent.

DWORD

dwDeviceID

Internal device ID. This ID ist generated by the driver depending on order of connection and camera type. The device ID is not persistent.

DWORD

dwSensorID

Sensor ID

DWORD

dwInUse

1 = camera is being used.

0 = camera is not being used.

Char

SerNo[16]

Serial number of the camera *)

Char

Model[16]

Camera model *)

DWORD

dwReserved[16]

Reserved for later use

Hinweis

*) The information from this data structure should not be used to find a specific camera (e.g. in order to control this specific camera). Instead, we recommend identifying a camera by a fixed camera ID or by the sensor ID.

Return Values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

IS_ACCESS_VIOLATION

Not enough memory allocated for the UEYE_CAMERA_LIST structure

IS_CANT_OPEN_DEVICE

Camera cannot be selected or initialized.

IS_IO_REQUEST_FAILED

Driver communication failed.

Related Functions

is_GetNumberOfCameras()

Code Sample


// At least one camera must be available

INT nNumCam;

if( is_GetNumberOfCameras( &nNumCam ) == IS_SUCCESS)

{

if( nNumCam >= 1 )

{

// Create new list with suitable size

UEYE_CAMERA_LIST* pucl;

pucl = (UEYE_CAMERA_LIST*) new char [sizeof (DWORD)
+ nNumCam
* sizeof (UEYE_CAMERA_INFO)];

pucl->dwCount = nNumCam;

 

//Retrieve camera info

if (is_GetCameraList(pucl) == IS_SUCCESS)

{

 int iCamera;

for (iCamera = 0; iCamera < (int)pucl->dwCount; iCamera++)

{

//Test output of camera info on the screen

printf("Camera %i Id: %d", iCamera,

pucl->uci[iCamera].dwCameraID);

}

}

}

}


Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com