THORLABS DCU223x Operation Manual And Sdk page 177

IS_CAP_STATUS_DRV_DEVICE_NOT_READ
Y
IS_CAP_STATUS_USB_TRANSFER_FAILED The image was not transferred over the USB bus.
IS_CAP_STATUS_DEV_TIMEOUT
Contents of the uc480_CAPTURE_STATUS_INFO structure
DWORD dwCapStatusCnt_Total
BYTE reserved[60]
DWORD adwCapStatusCnt_Detail[256] This array returns the current count for each possible
Return values
IS_INVALID_CAMERA_HANDLE
IS_INVALID_PARAMETER
IS_NO_SUCCESS
IS_SUCCESS
Related functions
is_GetError()
239
is_CameraStatus()
is_SetErrorReport()
Example 1
uc480_CAPTURE_STATUS_INFO CaptureStatusInfo;
INT nRet = is_CaptureStatus(m_hCam,
if (nRet == IS_SUCCESS)
{
UINT nConversionFailed = CaptureStatusInfo.adwCapStatusCnt_Detail[IS_CAP_STATUS_API_CONVERSION_FAILED]);
UINT nTotalInfos = CaptureStatusInfo.dwCapStatusCnt_Total;
}
© 2013 Thorlabs GmbH
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)
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.
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
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
Invalid camera handle
One of the submitted parameters is outside the valid range or is not
supported for this sensor or is not available in this mode.
General error message
Function executed successfully
172
326
IS_CAPTURE_STATUS_INFO_CMD_GET,
(void*)&CaptureStatusInfo,
sizeof(CaptureStatusInfo));
Returns the total number of errors occurred since the last
reset.
Reserved for an internal function
error. The possible errors are listed above.
4 Programming (SDK)
175