imgSequenceSetup
Usage
rval imgSequenceSetup(SESSION_ID sid, uInt32 numberOfBuffers, void* bufferList[ ], uInt32 skipCount[ ], uInt32 startNow, uInt32 async);
Purpose
Prepares a session for acquiring a sequence into the buffer list.
Parameters
| Name | Type | Direction |
| sid | SESSION_ID | input |
| numberOfBuffers | uInt32 | input |
| bufferList | void*[ ] | input/output |
| skipCount | uInt32[ ] | input |
| startNow | uInt32 | input |
| async | 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[ ]: array containing the number of images to skip before each acquisition.
 |
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.
async: if async is zero and startNow is non-zero, this function does not return until the acquisition completes. Otherwise, the function returns immediately.
Return Value
This function returns 0 on success. On failure, this function returns an error code. For information about the error code, call imgShowError.