imaq1394Grab2

Format

rval = imaq1394Grab2 (SESSION_ID sessionId, unsigned long waitForNextBuffer, unsigned long *bufferNumberActual, void **buffer);

Purpose

Acquires the most current frame into a previously allocated buffer. Call this function only after calling imaq1394SetupGrab.

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 actual cumulative buffer number of the image retrieved.
buffer	void **	The buffer that will contain 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.