Description

Initializes a streaming transfer of frames to the list of buffers indicated. The size of the buffers and the buffer cycling mode is also set.

Parameters

handle

Handle to the camera.

mode

Buffer cycling mode. Can be either :

Asynchronous: All buffers available all the time with no protection between the application and the acquisition process.

Or

SynchronousNextEmpty; Buffers obtained by the application are available only to the application until released back to the acquisition process. Buffers are filled in the order they are released back to the acquisition process. If there are no more buffers available to the acquisition process, subsequent images are not stored to memory and are deemed to have been sent to the “trash”.

bufSize

The allocated size of buffers to be used in the transfer.

numBuffers

Number of buffers addresses in array.

bufAddress

Array of buffer addresses (already allocated).

Return Value

GEV_STATUS

Possible values are:

GEVLIB_OK
GEVLIB_ERROR_INVALID_HANDLE
GEVLIB_ERROR_PARAMETER_INVALID
(GEV_REGISTER struct is not for an Integer register)
GEVLIB_ERROR_ARG_INVALID
(GEV_REGISTER definition is invalid)
GEVLIB_ERROR_SOFTWARE
(GEV_REGISTER struct defines an unsupported register type)

Note: Errors include attempting to initialize the transfer on a connection that is not set up for streaming.