Is_Freeimagemem - THORLABS DCU223x Operation Manual And Sdk

DCx Cameras

4.3.28 is_FreeImageMem

USB 2.0
USB 3.0
Syntax
INT is_FreeImageMem (HIDS hCam, char* pcImgMem, INT id)
Description
is_FreeImageMem() releases an image memory that was allocated using
removes it from the driver management.
Note
If the memory was not allocated using an SDK function, you need to call is_FreeImageMem() as well. Otherwise,
there may be errors when the driver keeps trying to access this memory.
This does however not release the memory. So you need to make sure that the memory will be released again.
Input parameters
hCam
pcImgMem
id
Return values
IS_CANT_ADD_TO_SEQUENCE
IS_CANT_CLEANUP_MEMORY
IS_CANT_COMMUNICATE_WITH_DRIVER
IS_CANT_OPEN_DEVICE
IS_INVALID_CAMERA_HANDLE
IS_INVALID_MEMORY_POINTER
IS_INVALID_PARAMETER
IS_IO_REQUEST_FAILED
IS_NO_SUCCESS
IS_SUCCESS
Related functions
is_AllocImageMem()
222
USB 2.0
USB 3.0
Camera handle
Points to the starting address of the memory (e.g. set in the
is_AllocImageMem()
ID of this memory
157
function)
157
The image memory is already included in the sequence
and cannot be added again.
The driver could not release the allocated memory.
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).
Invalid camera handle
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. Possibly the
versions of the uc480_api.dll (API) and the driver file
(uc480_usb.sys) do not match.
General error message
Function executed successfully
is_AllocImageMem()
© 2013 Thorlabs GmbH
and
157