| Home > Function descriptions > | History back Previous chapter Next chapter Print |
GetCaptureErrorInfo |
|
uEye ActiveX Manual Version 4.00
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 |
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