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.