 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_GetCameraList (UEYE_CAMERA_LIST* pucl)
Beschreibung
Mit is_GetCameraList() können Informationen über die angeschlossenen Kameras abgefragt werden. Um alle Informationen erhalten zu können, muss die Feldgröße an die Anzahl der angeschlossenen Kameras angepasst werden. In den nachfolgenden Tabellen werden die verwendeten Strukturen erläutert.
Übergabeparameter
pucl |
Handle auf Kamerastruktur UEYE_CAMERA_LIST |
Inhalt der Struktur UEYE_CAMERA_LIST
ULONG |
dwCount |
Muss mit der Anzahl der am System angeschlossenen Kameras vorbelegt werden. Dieser Wert kann über is_GetNumberOfCameras() ermittelt werden. |
UEYE_CAMERA_INFO |
uci[1] |
Platzhalter für 1 … n Strukturen UEYE_CAMERA_INFO |
Inhalt der Struktur UEYE_CAMERA_LIST::UEYE_CAMERA_INFO
DWORD |
dwCameraID |
Diese benutzerdefinierbare Kamera-ID ist dauerhaft und wird in der Kamera hinterlegt. Bei Auslieferung der Kamera ist als Wert 1 hinterlegt. |
DWORD |
dwDeviceID |
Systeminterne Geräte-ID. Diese ID wird vom Treiber je nach Anschlussreihenfolge und Kameratyp vergeben und ist nicht persistent. |
DWORD |
dwSensorID |
Sensor-ID, z.B. IS_SENSOR_UI124x_M Da der gleiche Sensor in verschiedenen Familien zum Einsatz kommt, liefert die Sensor-ID z.B. auch dann IS_SENSOR_UI124x_M zurück, wenn es eine sich um eine GigE uEye Kamera (UI-524x) handelt, da die erste Zahl nur die Kameraschnittstelle beschreibt. |
DWORD |
dwInUse |
1 = Kamera in Verwendung 0 = Kamera nicht in Verwendung |
Char |
SerNo[16] |
Seriennummer der Kamera |
Char |
Model[16] |
Kameramodell (Kurzbezeichnung) |
DWORD |
dwStatus |
Informationen zum Status der Kamera |
DWORD |
dwReserved[2] |
Reserviert |
IS_CHAR |
FullModelName[32] |
Kameramodell (voller Modellname) Hinweis: Verwenden Sie diesen String nur zur Anzeige. Die Modellbezeichnung kann sich bei einem Update des Kameratreibers ändern. |
DWORD |
dwReserved2[5] |
Reserviert |
|
Die Seriennummer oder Modellbezeichnung sollten nicht verwendet werden, um eine bestimmte Kamera zu finden (z. B. um gezielt eine Kamera anzusprechen). Wenn Sie die Seriennummer verwenden, findet die Software nach einem Kameratausch die Seriennummer nicht mehr. Die Modellbezeichnung kann sich bei einem Update des Kameratreibers ändern. Es wird empfohlen, Kameras stattdessen anhand einer individuellen Kamera-ID, dem Kameratyp oder der spezifischen Sensor-ID zu identifizieren. Die Kamera-ID bietet den Vorteil, dass Sie diese manuell festlegen, d.h. bei einem Kameratausch können Sie der neuen Kamera dieselbe Kamera-ID geben. |
Rückgabewert
IS_ACCESS_VIOLATION |
Es ist eine Zugriffsverletzung aufgetreten. Z. B. wurde zu wenig Speicher für die Struktur UEYE_CAMERA_LIST alloziert. |
IS_CANT_OPEN_DEVICE |
Ein Versuch die Kamera zu öffnen schlug fehl (Kamera nicht vorhanden oder Fehler beim Initialisieren). |
IS_INVALID_PARAMETER |
Einer der übergebenen Parameter ist außerhalb des gültigen Bereichs, oder für diesen Sensor nicht unterstützt, bzw. in diesem Modus nicht zugänglich. |
IS_IO_REQUEST_FAILED |
Eine IO Anforderung des uEye Treibers schlug fehl. Eventuell passen die Versionen der Dateien ueye_api.dll (API) und ueye_usb.sys bzw. ueye_eth.sys (Treiber) nicht zusammen. |
IS_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
Beispiel
// Mindestens eine Kamera muss verfügbar sein
INT nNumCam;
if( is_GetNumberOfCameras( &nNumCam ) == IS_SUCCESS) {
if( nNumCam >= 1 ) {
// Liste neu mit passender Größe anlegen
UEYE_CAMERA_LIST* pucl;
pucl = (UEYE_CAMERA_LIST*) new BYTE [sizeof (ULONG) + nNumCam * sizeof (UEYE_CAMERA_INFO)];
pucl->dwCount = nNumCam;
//Kamerainformationen einlesen
if (is_GetCameraList(pucl) == IS_SUCCESS) {
int iCamera;
for (iCamera = 0; iCamera < (int)pucl->dwCount; iCamera++) {
//Kamerainformationenam am Bildschirm ausgeben
printf("Camera %i Id: %d", iCamera,
pucl->uci[iCamera].dwCameraID);
}
}
delete [] pucl;
}
}
