 |
 |
|---|---|
USB 2.0 GigE |
USB 2.0 GigE |
Syntax
INT is_GetCaptureErrorInfo (HIDS hCam, UEYE_CAPTURE_ERROR_INFO* CaptureErrorInfo, UINT SizeCaptureErrorInfo)
Description
|
This function is obsolete and should not be used anymore. We recommend to use the is_CaptureStatus() function instead. |
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 |
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_GetError()
•is_SetErrorReport()
•is_CameraStatus()
