Is_Freezevideo - THORLABS DCU223x Operation Manual And Sdk

4.3.29 is_FreezeVideo

USB 2.0
USB 3.0
Syntax
INT is_FreezeVideo (HIDS hCam, INT Wait)
Description
is_FreezeVideo() acquires a single image from the camera. In DIB mode, the image is stored in the active
image memory. If ring buffering is used in DIB mode, the captured image is transferred to the next available image
m emory of the sequence. Once the last available sequence memory has been filled, the sequence event or
message will be triggered.
In Direct3D or OpenGL mode, the is directly copied to the graphics card buffer and then displayed.
Image capture will be started by a trigger
is_SetExternalTrigger()
is_StopLiveVideo()
For further information on the image capture modes of the DCx camera, see the
section.
134
Input parameters
hCam
Wait
IS_DONT_WAIT
IS_WAIT
Time t
Return values
IS_BAD_STRUCTURE_SIZE
IS_CANT_COMMUNICATE_WITH_DRIVER
IS_CANT_OPEN_DEVICE
IS_CAPTURE_RUNNING
IS_INVALID_BUFFER_SIZE
IS_INVALID_CAMERA_TYPE
IS_INVALID_EXPOSURE_TIME
IS_INVALID_CAMERA_HANDLE
IS_INVALID_MEMORY_POINTER
IS_INVALID_PARAMETER
IS_IO_REQUEST_FAILED
IS_NO_ACTIVE_IMG_MEM
IS_NO_USB20
© 2013 Thorlabs GmbH
USB 2.0
USB 3.0
. A hardware
327
if exposure has not started yet.
353
An internal structure has an incorrect size.
Communication with the driver failed because no driver has been
loaded.
An attempt to initialize or select the camera failed (no camera
connected or initialization error).
A capturing operation is in progress and must be terminated before
you can start another one.
The image memory has an inappropriate size to store the image in
the desired format.
The camera type defined in the .ini file does not match the current
camera model.
This setting is not available for the currently set exposure time.
Invalid camera handle
Invalid pointer or invalid memory ID
One of the submitted parameters is outside the valid range or is not
supported for this sensor or is not available in this mode.
An IO request from the uc480 driver failed. Possibly the versions of
the uc480_api.dll (API) and the driver file (uc480_usb.sys) do
not match.
No active image memory available. You must set the memory to
active using the is_SetImageMem() function or create a
sequence using the is_AddToSequence() function.
The camera is connected to a port which does not support the USB
2.0 high-speed standard.
if you previously enabled the trigger
triggered image acquisition
Camera handle
Timeout value for image capture (see also the
proceed: Timeout values for image capture
4 Programming (SDK)
mode using
can be cancelled
How to proceed: Image capture
How to
section)
135
using
223