IMAQdxConfigureGrab

NI-IMAQdx Function Reference

IMAQdxConfigureGrab

Format

rval = IMAQdxConfigureGrab (IMAQdxSession id);

Purpose

Configures and starts an acquisition. A grab performs an acquisition that loops continually on a ring of buffers. Use a grab for high-speed image acquisition. Use IMAQdxGrab to copy an image out of the buffer. If you call this function before calling IMAQdxOpenCamera, IMAQdxConfigureGrab uses cam0 by default. Use IMAQdxUnconfigureAcquisition to unconfigure the acquisition.

Parameters

Parameter Type Description
id IMAQdxSession A valid Session ID, which you can obtain using IMAQdxOpenCamera.

Return Value

On success, this function returns IMAQdxErrorSuccess. On failure, this function returns an error code. You can obtain a more detailed error message with IMAQdxGetErrorString or, if you are using Microsoft Visual Basic, IMAQdxGetErrorStringCW.