Home > Function descriptions > History back  Previous chapter  Next chapter  Print  

GetCaptureErrorInfo

uEye ActiveX Manual Version 4.00

GetCaptureErrorInfo

Syntax

VARIANT GetCaptureErrorInfo (ULONG* dwCapErrCnt_Total)

Description

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 ResetCaptureErrorInfo() function.

Parameters

dwCapErrCnt_Total

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

Return values

The VARIANT array contains the current count for each possible error. The possible errors are listed below.

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

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

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

Related functions

ResetCaptureErrorInfo()

GetError()

GetErrorText()


Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.


© 2012 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com