THORLABS DCU223x User Manual

© 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
DWORD
dwCapStatusCnt_Total
Returns the total number of errors occurred since the last
reset.
BYTE
reserved[60]
Reserved for an internal function
DWORD
adwCapStatusCnt_Detail[256]
This array returns the current count for each possible
error. The possible errors are listed above.
Return values
IS_INVALID_CAMERA_HANDLE
Invalid camera handle
IS_INVALID_PARAMETER
One of the submitted parameters is outside the valid range or is not
supported for this sensor or is not available in this mode.
IS_NO_SUCCESS
General error message
IS_SUCCESS
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

THORLABS DCU223x Specifications

General

Brand	THORLABS
Model	DCU223x
Category	Security Camera
Language	English