Is_Loadimagemem - THORLABS DCU223x Operation Manual And Sdk

DCx Cameras

4.5.14 is_LoadImageMem

USB 2.0
USB 3.0
Syntax
INT is_LoadImageMem (HIDS hCam, char* File, char** ppcImgMem, int* pid)
Description
Attention
This function is obsolete and should not be used anymore. We recommend to use the
function instead (see also
must have been saved in BMP format. The image, together with its color format and color depth properties, is
loaded into a newly allocated image memory.
Using the
is_FreeImageMem()
Input parameters
hCam
File
ppcImgMem
pid
Return values
IS_CANT_ADD_TO_SEQUENCE
IS_CANT_CLEANUP_MEMORY
IS_CANT_COMMUNICATE_WITH_DRIVER
IS_CANT_OPEN_DEVICE
IS_FILE_READ_INVALID_BMP_ID
IS_FILE_READ_INVALID_BMP_SIZE
IS_FILE_WRITE_OPEN_ERROR
IS_INVALID_CAMERA_HANDLE
IS_INVALID_MEMORY_POINTER
IS_INVALID_PARAMETER
IS_IO_REQUEST_FAILED
IS_NO_SUCCESS
IS_NOT_SUPPORTED
IS_OUT_OF_MEMORY
IS_SEQUENCE_BUF_ALREADY_LOCKED
IS_SUCCESS
Related functions
396
USB 2.0
USB 3.0
Obsolete functions ).is_LoadImageMem() loads an image from a file. The image
379
function, you can release the image memory again.
222
Camera handle
File name You can either pass an absolute or a relative path.
If NULL is passed, the "Open File" dialog opens.
Pointer to a variable containing the starting address
Pointer to a variable containing the memory ID
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).
The specified file is not a valid bitmap file.
The bitmap size is not correct (bitmap too large).
File cannot be opened for writing or reading.
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
The camera model used here does not support this
function or setting.
No memory could be allocated.
The memory could not be locked. The pointer to the
buffer is invalid.
Function executed successfully
is_ImageFile()
© 2013 Thorlabs GmbH
264