uEye Kamera-Handbuch Version 4.92
 |
 |
USB 2.0 USB 3.0 GigE |
USB 2.0 USB 3.0 GigE |
Syntax
INT is_WaitForNextImage (HIDS hCam, UINT timeout, char** ppcMem, INT* imageID)
Beschreibung
is_WaitForNextImage() gibt den Zeiger und die Sequenz-ID des ersten (d. h. des ältesten) Bildes einer Speichersequenz zurück. Für die Speichersequenz muss mit is_InitImageQueue() die Warteschlangen-Funktion aktiviert sein. Wenn kein Bild in der Sequenz enthalten ist, wartet is_WaitForNextImage() während der angegebenen Wartezeit, ob ein neues Bild eintrifft.
 |
Beachten Sie, dass auch Bildaufnahmefehler wie Bilder in die ImageQueue eingereiht werden. Liefert ein Aufruf von is_WaitForNextImage() den Rückgabewert IS_CAPTURE_STATUS zurück, dann können Sie über einen erneuten Aufruf der Funktion prüfen, ob nach dem Fehler weitere Bilder in die ImageQueue eingereiht wurden. |
 |
Bildspeicher aus einer Sequenz mit Warteschlangen-Funktion sind automatisch gelockt. Die Bildspeicher müssen mit is_UnlockSeqBuf() freigegeben werden, um wieder in der Sequenz verwendet werden zu können. |
Übergabeparameter
hCam |
Handle auf Kamera |
timeout |
Wartezeit in Millisekunden (ms). Wertebereich 0…232-1 Wenn sich kein Bild in der Sequenz befindet und innerhalb der Wartezeit kein Bild eintrifft, kehrt die Funktion mit IS_TIMED_OUT zurück. |
ppcMem |
Zeiger auf Variable, in die die Adresse des ältesten Bildes der Sequenz geschrieben wird. |
imageID |
Zeiger auf Variable, in die die Sequenz-ID (Position in der Sequenzliste) des ältesten Bildes der Sequenz geschrieben wird. |
Rückgabewert
IS_CANT_COMMUNICATE_WITH_DRIVER |
Kommunikation mit dem Kameratreiber schlug fehl, weil kein Treiber geladen ist. |
IS_INVALID_CAMERA_HANDLE |
Ungültiges Kamera-Handle |
IS_INVALID_MEMORY_POINTER |
Ungültiger Zeiger oder ungültige Speicher-ID |
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 |
IS_TIMED_OUT |
Ein Timeout trat auf. Eine Bildaufnahme konnte nicht in der vorgeschriebenen Zeit beendet werden. |
IS_CAPTURE_STATUS |
Es ist ein Übertragungsfehler aufgetreten oder es war kein Bildspeicher zum Befüllen verfügbar. Mit is_CaptureStatus() kann die Fehlerursache abgefragt werden. So könnte z. B. der Bildspeicher gesperrt sein und mit is_UnlockSeqBuf() zuerst freigegeben werden. Der Parameter IS_CAPTURE_STATUS ersetzt den bisherigen Parameter IS_TRANSFER_FAILED. Der Parameter IS_TRANSFER_FAILED wurde in die neue Header-Datei ueye_deprecated.h verschoben, die alle veralteten Funktionsdefinitionen und Konstanten enthält. Falls Bedarf besteht, kann die Header-Datei ueye_deprecated.h zusätzlich zu ueye.h eingebunden werden. |
Verwandte Funktionen
Siehe auch: •Vorgehensweise: Sequenz-Bildspeicher •Vorgehensweise: Bildspeicher anlegen •Übertragungsfehler: uEye Cockpit Host Performance •Übertragungsfehler: is_GetImageInfo() |
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.