## Please enable JavaScript to view this site.

# FALCON/EAGLE user manual 4.62

- Zoom window out
- Larger text | Smaller text
- Hide page header
- Show expanding text
- Print topic
- Send mail feedback
- Copy topic URL

is_SetAllocatedImageMem | Scroll Previous Top Next More

| 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

© 2020 IDS Imaging Development Systems GmbH