IDS Software Suite 4.96.1
 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_SetImageMem (HIDS hCam, char* pcMem, INT nMemId)
Description
is_SetImageMem() makes the specified image memory the active memory. Only an active image memory can receive image data. When you call is_FreezeVideo(), the captured image is stored in the image buffer designated by pcMem and nMemId. For pcMem, you must pass a pointer which was created by is_AllocImageMem(), passing any other pointer will result in an error message. You may pass the same pointer multiple times.
|
In the Direct3D or OpenGL modes, there is no need to set an image memory. |
If the specified image memory is set as active memory, a previously created sequence list is deleted and a new sequence list is created with this image memory. If image memories of the already existing sequence list are locked by the user and thus signaled as used, the image memories cannot be removed from the sequence list. So the sequence list is not deleted. Therefore, before calling is_SetImageMem(), all image memories locked using is_LockSeqBuf() have to be unlocked using is_UnlockSeqBuf() first.
Input parameters
hCam |
Camera handle |
pcMem |
Pointer to the starting position in the memory. |
nMemId |
ID of this memory. |
Return values
IS_INVALID_CAMERA_HANDLE |
Invalid camera handle |
IS_NO_SUCCESS |
General error message |
IS_SEQ_BUFFER_IS_LOCKED |
The image memory is locked. At least one image memory is locked in the active sequence list. Therefore, the sequence list cannot be deleted and the specified image memory cannot be set active. |
IS_SUCCESS |
Function executed successfully |
Related functions
