© 2013 Thorlabs GmbH
4 Programming (SDK)
175
was discarded.
Possible cause/remedy
The computer takes too long to process the images in the uc480
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)
IS_CAP_STATUS_DRV_DEVICE_NOT_READ
Y
The camera is no longer available. It is not possible to access
images that have already been transferred.
Possible cause
The camera has been disconnected or closed.
IS_CAP_STATUS_USB_TRANSFER_FAILED
The image was not transferred over the USB bus.
Possible cause/remedy
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
IS_CAP_STATUS_DEV_TIMEOUT
The maximum allowable time for image capturing in the camera
was exceeded.
Possible cause/remedy
The selected timeout value is too low for image capture
Reduce the exposure time
Increase the timeout
Contents of the uc480_CAPTURE_STATUS_INFO structure
Returns the total number of errors occurred since the last
reset.
Reserved for an internal function
adwCapStatusCnt_Detail[256]
This array returns the current count for each possible
error. The possible errors are listed above.
Return values
One of the submitted parameters is outside the valid range or is not
supported for this sensor or is not available in this mode.
Function executed successfully
Related functions
is_GetError()
is_CameraStatus()
is_SetErrorReport()
Example 1
uc480_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;
}
239
172
326