 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_CaptureStatus (HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)
Beschreibung
Die Funktion liefert Informationen zu Fehlern, die bei der Bildaufnahme aufgetreten sind. Es werden alle Fehler angezeigt, die seit dem letzten Zurücksetzen der Funktion aufgetreten sind.
Über den Übergabeparameter nCommand wird dabei der Funktionsmodus gewählt. Der Übergabeparameter pParam ist abhängig vom Funktionsmodus unterschiedlich belegt; bei Funktionen zum Setzen oder Rücklesen eines Wertes enthält pParam einen Zeiger auf eine Variable vom Typ UINT. Die Größe des Speicherbereichs, auf den pParam verweist, wird im Übergabeparameter cbSizeOfParam angegeben.
Übergabeparameter
hCam |
Handle auf Kamera |
pParam |
Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist. |
cbSizeOfParam |
Größe des Speicherbereichs in Byte, auf den pParam verweist. |
Inhalte der Enumeration UEYE_CAPTURE_STATUS
IS_CAP_STATUS_API_NO_DEST_MEM |
Es ist kein Zielspeicher zum Kopieren des fertigen Bildes vorhanden.
|
|
IS_CAP_STATUS_API_CONVERSION_FAILED |
Das aktuelle Bild konnte nicht korrekt verarbeitet werden.
|
|
IS_CAP_STATUS_API_IMAGE_LOCKED |
Die Zielbildspeicher sind gesperrt und konnten nicht beschrieben werden.
|
|
IS_CAP_STATUS_DRV_OUT_OF_BUFFERS |
Dem Treiber steht kein freier interner Bildspeicher zur Verfügung. Das Bild wurde verworfen.
|
|
IS_CAP_STATUS_DRV_DEVICE_NOT_READY |
Die Kamera ist nicht mehr verfügbar. Auf bereits übertragene Bilder kann nicht zugegriffen werden.
|
|
IS_CAP_STATUS_TRANSFER_FAILED |
Das Bild konnte nicht übertragen werden.
|
|
IS_CAP_STATUS_DEV_TIMEOUT |
Die maximal zulässige Zeit für die Bildaufnahme in der Kamera wurde überschritten.
|
|
IS_CAP_STATUS_ETH_BUFFER_OVERRUN |
Der Sensor liefert mehr Daten, als der interne Kameraspeicher der GigE uEye Kamera aufnehmen kann.
|
|
IS_CAP_STATUS_ETH_MISSED_IMAGES / IS_CAP_STATUS_DEV_MISSED_IMAGES |
Freilaufender Modus: Ein vom Sensor aufgenommenes Bild konnte von der Kamera nicht verarbeitet und ausgegeben werden. Hardware-Triggermodus: Die Kamera hat ein Hardwaretrigger-Signal erkannt, das nicht verarbeitet werden konnte, weil bereits eine Bildaufnahme aktiv war.
|
|
IS_CAP_STATUS_DEV_FRAME_CAPTURE_FAILED |
Nur USB 3 uEye CP Rev. 2 im Speicherbetrieb: Das Bild wurde nicht übertragen.
|
Inhalte der Struktur UEYE_CAPTURE_STATUS_INFO
DWORD |
dwCapStatusCnt_Total |
Gibt die Gesamtzahl aller seit dem letzten Reset aufgetretenen Fehler zurück. |
BYTE |
reserved[60] |
Reserviert für interne Funktion |
DWORD |
adwCapStatusCnt_Detail[256] |
Dieses Array gibt für jeden möglichen Fehler den aktuellen Zählerstand zurück. Die möglichen Fehler sind oben aufgeführt. |
Rückgabewerte
IS_INVALID_CAMERA_HANDLE |
Ungültiges Kamera-Handle |
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_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
UEYE_CAPTURE_STATUS_INFO CaptureStatusInfo;
INT nRet = is_CaptureStatus(m_hCam, IS_CAPTURE_STATUS_INFO_CMD_GET, (void*)&CaptureStatusInfo,
sizeof(CaptureStatusInfo));
if (nRet == IS_SUCCESS)
{
UINT nConversionFailed = CaptureStatusInfo.adwCapStatusCnt_Detail[IS_CAP_STATUS_API_CONVERSION_FAILED];
UINT nTotalInfos = CaptureStatusInfo.dwCapStatusCnt_Total;
}
INT nRet = is_CaptureStatus(m_hCam, IS_CAPTURE_STATUS_INFO_CMD_RESET, NULL, 0);
