imaqSetupGrab

NI Vision for LabWindows/CVI Function

imaqSetupGrab

Usage

int imaqSetupGrab(SESSION_ID sessionID, Rect rect);

Purpose

Configures and starts a grab acquisition. A grab performs an acquisition that loops continually on one buffer. Use imaqGrab() to copy an image out of the buffer. Use imaqStopAcquisition() to end the acquisition.

Parameters

Name

Type

Description

sessionID SESSION_ID A valid session ID.
rect Rect The area to acquire. If you set this parameter to IMAQ_NO_RECT, the function uses the entire acquisition window.

Return Value

Type

Description

int On success, this function returns a non-zero value. On failure, this function returns 0. To get extended error information, call imaqGetLastError().