Is_Capturestatus - THORLABS DCU223x Operation Manual And Sdk

DCx Cameras

4.3.7 is_CaptureStatus

USB 2.0
USB 3.0
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
hCam
nCommand
IS_CAPTURE_STATUS_INFO_CMD_GET
IS_CAPTURE_STATUS_INFO_CMD_RESET
pParam
cbSizeOfParam
Content of the uc480_CAPTURE_STATUS enumeration
IS_CAP_STATUS_API_NO_DEST_MEM
IS_CAP_STATUS_API_CONVERSION_FAIL
ED
IS_CAP_STATUS_API_IMAGE_LOCKED
IS_CAP_STATUS_DRV_OUT_OF_BUFFERS
174
USB 2.0
USB 3.0
.
379
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
The current image could not be processed correctly.
Possible cause
Internal error during internal processing of the image
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
No free internal image memory is available to the driver. The image
Camera handle
Returns the CaptureStatus information
Resets the CaptureStatus infomation
Pointer to a function parameter, whose function depends
on nCommand.
Size (in bytes) of the memory area to which pParam
refers.
(Example 1
175
(Example 2 )
176
© 2013 Thorlabs GmbH
)