is_SetStarterFirmware

uEye Kamera-Handbuch Version 4.92


is_SetStarterFirmware

Windows_Logo
Linux_Logo

GigE

GigE

Syntax

INT is_SetStarterFirmware (HIDS hDev, const CHAR* pcFilepath, UINT uFilepathLen)

Beschreibung

Mit is_SetStarterFirmware() kann ein Update der Starter-Firmware einer angeschlossenen Kamera vorgenommen werden. Das Starter-Firmware-Update kann auch über den IDS Kameramanager vorgenommen werden.

hint_attention

Die Starter-Firmware ist für das Startverhalten der GigE uEye Kamera verantwortlich. Ein Update der Starter-Firmware sollte nur durchgeführt werden, wenn mit einer älteren Version der Firmware Startprobleme auftreten. Bei Fragen zur aktuellen Starter-Firmware kontaktieren Sie unsere Systemberatung.

Übergabeparameter

hDev

DevID | IS_USE_DEVICE_ID
DevID = systeminterne Geräte-ID der Kamera aus der Struktur UEYE_CAMERA_INFO (siehe auch is_GetCameraList())

pcFilepath

Zeiger auf einen nullterminierten ASCII-String, der den vollständigen Dateipfad enthält.

uFilepathLen

Länge des Dateipfades in Byte

hint_attention

Die Funktion is_SetStarterFirmware() nimmt als Parameter hDev kein Kamera-Handle entgegen. Der Aufruf muss, wie beschrieben, über die interne Geräte-ID erfolgen.

Rückgabewert

IS_BAD_STRUCTURE_SIZE

Eine interne Struktur hat die falsche Größe.

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_NOT_SUPPORTED

Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht.

IS_SUCCESS

Funktion erfolgreich

Verwandte Funktionen

•is_GetCameraList()

•is_GetDuration()

•is_InitCamera()

Beispiel

// Prepare the data parameter.

const CHAR kFilepath[]= "c:\\ids\\firmware.fw";

 

// Prepare the handle parameter. mark the given device id with IS_USE_DEVICE_ID.

HIDS hDev = (HIDS)( dwDeviceID | IS_USE_DEVICE_ID);

INT nRet = is_SetStarterFirmware( hDev, kFilepath, sizeof(kFilepath));

Haben Sie Verbesserungshinweise? Senden Sie ein kurzes Feedback zu diesem Kapitel. Vielen Dank!
Bei technischen Fragen wenden Sie sich bitte an Ihren lokalen Händler oder nutzen Sie das Support-Formular auf unserer Internetseite.


© 2019 IDS Imaging Development Systems GmbH
https://de.ids-imaging.com