imaq1394GetBuffer

Format

rval = imaq1394GetBuffer (SESSION_ID sessionID, unsigned long imageIndex, void **buffer);

Purpose

Gets a single image from a low-level acquisition setting. This function takes a buffer as an input. The buffer must be large enough to contain the entire image.

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.
Buffer	void * (passed by reference)	The buffer that contains the 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.