is_LockSeqBuf

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

GigE

Syntax

INT is_LockSeqBuf (HIDS hCam, INT nNum, char* pcMem)

Description

is_LockSeqBuf() locks write access to an image memory within a sequence. In the capturing process, locked image memories will be skipped in the sequence list of image memories to be used. This way, you can avoid that image data which are required for further processing will be overwritten by newly captured data. Full access to the image memory is still guaranteed. You can lock any number of image memories at the same time.

Using the is_UnlockSeqBuf() function, you can re-enable write access to the image memory.

Input parameters

hCam	Camera handle
nNum	Number of the image memory to be locked (1…max) or IS_IGNORE_PARAMETER: The image memory will be identified by its starting address only.
pcMem	Starting address of the image memory to be locked

Achtung

nNum indicates the location in the sequence list, not the memory ID assigned using is_AllocImageMem().

Return values

IS_BAD_STRUCTURE_SIZE	An internal structure has an incorrect size.
IS_INVALID_CAMERA_HANDLE	Invalid camera handle
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_NO_SUCCESS	General error message
IS_SUCCESS	Function executed successfully

Related functions

•is_UnlockSeqBuf()

•is_AddToSequence()

•is_SetImageMem()

•is_SetAllocatedImageMem()

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_LockSeqBuf