THORLABS DCU223 SERIES User Manual

© 2013 Thorlabs GmbH226
DCx Cameras
4.3.31 is_GetActSeqBuf
USB 2.0
USB 3.0
USB 2.0
USB 3.0
Syntax
INT is_GetActSeqBuf (HIDS hCam, INT* pnNum,
char** ppcMem, char** ppcMemLast);
Description
Using is_GetActSeqBuf(), you can determine the image memory which is currently used for capturing an
image (ppcMem) or the image memory that was last used for capturing an image (ppcMemLast). This function
is only available if you have enabled ring buffering.
Attention
All input parameters of a function have to be initialized with valid values before the function is called; this also
applies to parameters that are not used. Variables can be preset with '0', for example. For unused parameters, the
NULL pointer has to be passed.
Note
This number is not the ID of the image memory that was allocated using the is_AllocImageMem() function,
but the running number from the order in which memory was allocated by the is_AddToSequence() function.
Input parameters
hCam
Camera handle
pnNum
Contains the number of the image memory currently used for image capturing.
If image capturing is already in progress when is_GetActSeqBuf() is
called, pnNum will return the value 0 until the sequence arrives at the first image
memory again.
ppcMem
Contains the starting address of the image memory currently used for image
capturing.
ppcMemLast
Contains the starting address of the image memory last used for image
capturing.
Return values
IS_CANT_COMMUNICATE_WITH_DRIVER
Communication with the driver failed because no driver
has been loaded.
IS_CANT_OPEN_DEVICE
An attempt to initialize or select the camera failed (no
camera connected or initialization error).
IS_INVALID_CAMERA_HANDLE
Invalid camera handle
IS_INVALID_MEMORY_POINTER
Invalid pointer or invalid memory ID
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_IO_REQUEST_FAILED
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.
IS_NO_SUCCESS
General error message
IS_SEQUENCE_LIST_EMPTY
The sequence list is empty and cannot be deleted.
IS_SUCCESS
Function executed successfully
Related functions
is_AddToSequence()
is_GetImageMem()
157
156
156
247

THORLABS DCU223 SERIES Specifications

General

Brand	THORLABS
Model	DCU223 SERIES
Category	Security Camera
Language	English