imaq1394GetImage

Format

rval = imaq1394GetImage (SESSION_ID sessionID, unsigned long imageIndex, Image *image);

Purpose

Gets a single image from a low-level acquisition session using IMAQ Vision memory management. If the image type does not match the video format of the camera, imaq1394GetImage changes it to a suitable format.

Parameters

Parameter	Type	Description
sessionID	SESSION_ID	A valid Session ID, which you can obtain with the function imaq1394CameraOpen.
imageIndex	unsigned long	The index of the image to retrieve. This parameter is used only in non-continuous acquisitions using multiple buffers (sequence acquisitions). Set this parameter to 0 for continuous acquisitions.
Image	Image (passed by reference)	The buffer that contains the IMAQ Vision image when the function returns.

Return Value

On success, this function returns IMG1394_ERR_GOOD. On failure, this function returns an error code. You can obtain a more detailed error message with imaq1394ShowError.