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

is_GetCaptureErrorInfo

uEye Camera Manual Version 3.80

is_GetCaptureErrorInfo

Windows_Logo

Linux_Logo

USB 2.0

GigE

USB 2.0

GigE

Syntax

INT is_GetCaptureErrorInfo (HIDS hCam,
UEYE_CAPTURE_ERROR_INFO* CaptureErrorInfo,
UINT SizeCaptureErrorInfo)

Description

is_GetCaptureErrorInfo() returns detail information on errors that occurred during an image capture process. The function lists all errors that occurred since the last call of the is_ResetCaptureErrorInfo() function.

Input Parameters

hCam

Camera handle

CaptureErrorInfo

Structure of the UEYE_CAPTURE_ERROR_INFO type that is filled by the uEye driver. This structure then contains the error list.

SizeCaptureErrorInfo

Indicates the size of the CaptureErrorInfo structure.

Contents of the UEYE_CAPTURE_ERROR_INFO Structure

DWORD

dwCapErrCnt_Total

Returns the total number of errors occurred since the last reset.

BYTE

reserved[60]

Reserved for an internal function

DWORD

adwCapErrCnt
_Detail[CapErr]

This array returns the current count for each possible error. The possible errors are listed below. To query the counter of a specific error type, pass its definition in the CapErr parameter.

Possible CapErr Error Types

Definition

Description

#

IS_CAPERR_API_NO_DEST_MEM

There is no destination memory for copying the finished image.

1

IS_CAPERR_API_CONVERSION_FAILED

The current image could not be processed correctly.

2

IS_CAPERR_API_IMAGE_LOCKED

The destination buffers are locked and could not be written to.

3

IS_CAPERR_DRV_OUT_OF_BUFFERS

No free internal image memory is available to the driver. The image was discarded.

4

IS_CAPERR_DRV_DEVICE_NOT_READY

The camera is no longer available. It is not possible to access images that have already been transferred.

5

IS_CAPERR_USB_TRANSFER_FAILED

The image was not transferred over the USB bus.

6

IS_CAPERR_DEV_TIMEOUT

The maximum allowable time for image capturing in the camera was exceeded.

7

IS_CAPERR_ETH_BUFFER_OVERRUN

The sensor transfers more data than the internal camera memory of the GigE uEye can accommodate.

8

IS_CAPERR_ETH_MISSED_IMAGES

Freerun mode: The GigE uEye camera could neither process nor output an image captured by the sensor.

Hardware trigger mode: The GigE uEye camera received a hardware trigger signal which could not be processed because the sensor was still busy.

9

 

#

Possible cause

Remedy

1

Not enough destination memory allocated or all destination buffers locked by the application

Release locked destination memory
Allocate more destination memory
Reduce the frame rate so that there is more time to process the filled destination memory

2

Internal error during internal processing of the image

-

3

All destination buffers locked by the application

Release locked destination memory
Allocate more destination memory
Reduce the frame rate so that there is more time to process the filled destination memory

4

The computer takes too long to process the images in the uEye API (e.g. color conversion)

Reduce the frame rate so that there is more time to process the filled image memory of the driver
Disable resource-intensive API image pre-processing functions (e.g. edge enhancement, color correction, choose smaller filter mask for software color conversion)

5

The camera has been disconnected or closed

-

6

Not enough free bandwidth on the USB bus for transferring the image

Reduce the pixel clock frequency
Operate fewer cameras simultaneously on a USB bus
Check the quality of the USB cabling and
components

7

The selected timeout value is too low for image capture

Reduce the exposure time
Increase the timeout

8

The selected data rate of the sensor is too high

Reduce the pixel clock frequency
Reduce the frame rate
Reduce the image size

9

The camera's frame rate is too high or the bandwidth on the network is insufficient to transfer the image

Reduce the frame rate
Increase the value for the receive descriptors in the network card settings

Return Values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

Related Functions

is_ResetCaptureErrorInfo()
is_GetError()
is_CameraStatus()
is_SetErrorReport()

 

See also:


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