© 2013 Thorlabs GmbH174
DCx Cameras
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.
Possible cause
Internal error during internal processing of the image
IS_CAP_STATUS_API_IMAGE_LOCKED
The destination buffers are locked and could not be written to.
Possible cause/remedy
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_DRV_OUT_OF_BUFFERS
No free internal image memory is available to the driver. The image
379
175
176
To Next Page
Loading...
Need help?
General
