© 2016 Thorlabs Scientific Imaging138
DCx Camera Functional Description and SDK Manual
4.3.7 is_CaptureStatus
Syntax
INT is_CaptureStatus (HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)
Description
The function returns information on errors that occurred during an image capture. All errors are
listed that occurred since the last reset of the function.
The nCommand input parameter is used to select the function mode. The pParam input parameter
depends on the selected function mode. If you select functions for setting or returning a value,
pParam contains a pointer to a variable of the UINT type. The size of the memory area to which
pParam refers is specified in the cbSizeOfParam input parameter.
Note
The following functions are obsolete by the is_CaptureStatus() function:
is_GetCaptureErrorInfo()
is_ResetCaptureErrorInfo()
See also Obsolete functions.
Input parameters
IS_CAPTURE_STATUS_INFO_CMD_GET
Returns the CaptureStatus information
(Example 1)
IS_CAPTURE_STATUS_INFO_CMD_RESET
Resets the CaptureStatus infomation (Example
2)
Pointer to a function parameter, whose function
depends on nCommand.
Size (in bytes) of the memory area to which
pParam refers.
Content of the uc480_CAPTURE_STATUS enumeration
IS_CAP_STATUS_API_NO_DEST_MEM
There is no destination memory for copying the finished
image.
Possible cause/remedy
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
IS_CAP_STATUS_API_CONVERSION_FAIL
ED
The current image could not be processed correctly.