imaq1394GrabImage2

Format

rval = imaq1394GrabImage2 (SESSION_ID sessionId, unsigned long waitForNextBuffer, unsigned long *bufferNumberActual, Image *image);

Purpose

Acquires the most current frame into the specified IMAQ Vision image buffer. Call this function only after calling imaq1394SetupGrab. If the image type does not match the video format of the camera, this function changes the image type to a suitable format.

Parameters

Parameter	Type	Description
sessionId	SESSION_ID	A valid Session ID, which you can obtain using imaq1394CameraOpen2.
waitForNextBuffer	unsigned long	Specifies whether the function returns the image currently being acquired or the last completely acquired image. Specify TRUE (1) to wait for a buffer. Specify FALSE (0) to get the current buffer in memory. The default value is TRUE.
bufferNumberActual	unsigned long *	On return, the buffer number of the image returned.
Image	Image *	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.