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

is_WaitForNextImage

uEye Camera Manual Version 3.80

is_WaitForNextImage

Windows_Logo

Linux_Logo

USB 2.0

GigE

USB 2.0

GigE

Syntax

INT is_WaitForNextImage(HIDS hCam, UINT timeout,
char** ppcMem, INT* imageID)

Description

is_WaitForNextImage() returns the pointer and sequence ID of the last (i.e. oldest) image in a memory sequence. The        queue mode has to be enabled for the memory sequence (see is_InitImageQueue()). If the sequence does not contain images, is_WaitForNextImage() waits until a new image arrives or until the specified time has elapsed.

Achtung

Image memories in a sequence with queue mode are automatically locked. The image memories will have to be unlocked with is_UnlockSeqBuf() in order to be re-used in the sequence.

Input Parameters

hCam

Camera handle

timeout

Timeout in ms. If no images are in the sequence and no image arrives during the timeout, the function returns IS_TIMED_OUT.

ppcMem

Pointer to a variable which will receive the address of the last image in the sequence.

imageID

Pointer to a variable which will receive the sequence ID of the last image in the sequence.

Return Values

IS_SUCCESS

Function executed successfully

IS_TRANSFER_FAILED

An error occurred during the data transfer or unlocked image memory is available in the sequence.

IS_TIMED_OUT

No image arrived during the specified time.

IS_NO_SUCCESS

General error message

Related Functions

is_InitImageQueue()
is_ExitImageQueue()
is_UnlockSeqBuf()

See also:

How to proceed: Image Memory Sequences
How to proceed: Allocating Image Memory
Transfer error: uEye Demo Image Infos
Transfer error: is_GetImageInfo()

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


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