|
The is_SetAllocatedImageMem() function cannot be used on 64 bit systems as on these user allocated memories are not supported. |
Syntax
INT is_SetAllocatedImageMem (HIDS hf, INT width, INT height, INT bitspixel, char* pcImgMem, int* pid)
Description
is_SetAllocatedImageMem() defines an allocated memory to the current memory, in which the image will be digitized. The size of memory must be large enough and must be locked global! Such a built up memory can be used in a sequence. It has to be taken from the driver office with function is_FreeImageMem(), before it is actually released. The allocated memory must not be reallocated.
The following steps have to be done:
1.Allocate memory: HANDLE hgMem = GlobalAlloc (size);
2.Lock memory: char* pcMem = (char*) GlobalLock (hgMem);
With function is_SetAllocatedImageMem() the address of the memory is given to FALCON/EAGLE driver. Additionally as with function is_AllocImageMem() the size of the image must be set and as a result a identification number (pid) returns. This number might be needed in other functions.
is_SetAllocatedImageMem (hf, width, height, bitspixel, pcMem, &ID);
|
size >= (width * height * bitspixel/8) |
Now the image memory can be used. Sequences are also possible.
The area of the memory must be taken from driver office again: is_FreeImageMem (hf, pcMem, ID);
With this the memory is not released.
The user must take care, that the memory is released:
GlobalUnlock (hgMem);
GlobalFree (hgMem);
Parameters
hf |
Frame grabber handle |
width |
Width of image |
height |
Height of image |
bitspixel |
Color depth of image (bits per pixel) |
pcImgMem |
Contains pointer to beginning of memory |
pid |
Contains the ID for memory |
Return value
IS_SUCCESS, IS_NO_SUCCESS
