© 2016 Thorlabs Scientific Imaging
4 Programming (SDK)
219
4.3.32 is_GetActSeqBuf
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
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.
Contains the starting address of the image memory currently used
for image capturing.
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.
An attempt to initialize or select the camera
failed (no camera connected or initialization
error).
IS_INVALID_MEMORY_POINTER
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.
To Next Page
Loading...
Need help?
General
