imgRingSetup

Usage

rval imgRingSetup(SESSION_ID sid, uInt32 numberOfBuffers, void* bufferList[ ], uInt32 skipCount, uInt32 startNow);

Purpose

Prepares a session for acquiring continuously and looping into a buffer list.

Parameters

Name	Type	Direction
sid	SESSION_ID	input
numberOfBuffers	uInt32	input
bufferList	void*[ ]	input/output
skipCount	uInt32	input
startNow	uInt32	input
rval	Int32	output

Parameter Discussion

sid: valid SESSION_ID

numberOfBuffers: number of buffers in the buffer list.

bufferList[ ]: array of buffer pointers. For each element in the buffer list that is initialized to NULL, bufferList[ ] allocates a buffer and returns this buffer address in the array element. This function acquires into the buffer for each element that is not NULL.

skipCount: number of images to skip before acquiring each buffer. This number is the same for all acquisitions.

Note  skipCount is not supported for line scan acquisitions. Refer to imgSessionLineTrigSource2 for information about triggering line scan skip triggers.

Note  skipCount is not supported on the NI 1427, NI 1429, or NI 1430.

startNow: non-zero value specifies that the continuous acquisition should start immediately. If the value is zero, you must manually start the acquisition with imgSessionStartAcquisition.

Return Value

This function returns 0 on success. On failure, this function returns an error code. For information about the error code, call imgShowError.