GEV_STATUS GevInitImageTransfer

(GEV_CAMERA_HANDLE handle, GevBufferCyclingMode mode,
 UINT32 numBuffers, UINT8 **bufAddress);

Description

Initializes a streaming transfer to the list of buffers indicated. 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”.

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.

Replacement Function

GevInitializeTransfer

Related Topics

Appendix D: Legacy Functions