imaq1394ConfigureAcquisition

NI-IMAQ for IEEE 1394 Cameras Function

imaq1394ConfigureAcquisition

Format

rval = imaq1394ConfigureAcquisition (SESSION_ID sessionId, unsigned int continuous, unsigned int bufferCount, Rect rectangle);

Purpose

Configures a low-level acquisition previously opened with imaq1394CameraOpen2. Specify the acquisition type with the continuous and bufferCount parameters.

Snap Continuous = 0 Buffer Count = 1
Sequence Continuous = 0 Buffer Count > 1
Grab Continuous = 1 Buffer Count ³ 1

Use imaq1394ClearAcquisition to unconfigure the acquisition.

Parameters

Parameter Type Description
sessionId SESSION_ID A valid Session ID, which you can obtain using imaq1394CameraOpen2.
continuous unsigned int Specifies whether the acquisition is continuous or one-shot.
bufferCount unsigned int For a one-shot acquisition, this parameter specifies the number of images to acquire. For a continuous acquisition, this parameter specifies the number of buffers the driver uses internally.
rectangle Rect The area to acquire. Set this parameter to IMAQ_NO_RECT to acquire the entire acquisition window.

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.