Home > C: Programming > Function descriptions > History back  Previous chapter  Next chapter  Print  

is_InquireImageMem

uEye Camera Manual Version 4.00

is_InquireImageMem

Windows_Logo

Linux_Logo

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

GigE

Syntax

INT is_InquireImageMem (HIDS hCam, char* pcMem, int nID,
                       int* pnX, int* pnY,
                       int* pnBits, int* pnPitch);

Description

is_InquireImageMem() reads out the properties of an allocated image memory.

Input parameters

hCam

Camera handle

pMem

Pointer to the starting address of the image memory as allocated by is_AllocImageMem()

NID

ID of the image memory as allocated by is_AllocImageMem()

pnX

Returns the width used to define the image memory. You can also pass NULL instead.

pnY

Returns the height used to define the image memory. You can also pass NULL instead.

pnBits

Returns the bit width used to define the image memory. You can also pass NULL instead.

pnPitch

Returns the line increment of the image memory. You can also pass NULL instead.

Return values

IS_CANT_COMMUNICATE_WITH_DRIVER

Communication with the driver failed because no driver has been loaded.

IS_CANT_OPEN_DEVICE

An attempt to initialize or select the camera failed (no camera connected or initialization error).

IS_INVALID_CAMERA_HANDLE

Invalid camera handle

IS_INVALID_MEMORY_POINTER

Invalid pointer or invalid memory ID

IS_INVALID_PARAMETER

One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode.

IS_IO_REQUEST_FAILED

An IO request from the uEye driver failed. Possibly the versions of the ueye_api.dll (API) and the driver file (ueye_usb.sys or ueye_eth.sys) do not match.

IS_NO_SUCCESS

General error message

IS_SUCCESS

Function executed successfully

Related functions

is_AllocImageMem()

is_SetImageMem()

is_SetAllocatedImageMem()

is_GetColorDepth()


Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.


© 2012 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com