is_GetActSeqBuf

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

GigE

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.

Achtung

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.

Hinweis

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 uEye driver failed. Possibly the versions of the ueye_api.dll (API) and the driver file (ueye_usb.sys or ueye_eth.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()

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.

Home > C: Programming > Function descriptions >	History back Previous chapter Next chapter Print
is_GetActSeqBuf