GEV_STATUS GevQueryImageTransferStatus

(GEV_CAMERA_HANDLE handle,
 PUINT32 pTotalBuffers, PUINT32 pNumUsed,
 PUINT32 pNumFree, PUINT32 pNumTrashed,
 GevBufferCyclingMode *pMode);

Description

Releases an image object back to the acquisition process for re-use. It is mandatory to call this function for a transfer using the SynchronousNextEmpty cycle mode in order to avoid running out of images for the acquisitions process to fill. It is not necessary to call this function for a transfer using the Asynchronous cycle mode..

Parameters

handle

Handle to the camera

pTotalBuffers

Pointer to receive the total number of buffers in the transfer list.

pNumUsed

Pointer to receive the number of filled buffers ready to be received from the transfer list.

pNumFree

Pointer to receive the number of empty (free) buffers that are available to be filled.

pNumTrashed

Pointer to receive the total number of buffers that have been “trashed” so far. (i.e. Frames that are  dropped when there are no more empty buffers to fill but image data has still been received).

pMode

Pointer to receive the current buffer cycling mode (Asynchronous=0, SynchronousNextEmpty=1).

 

 

Return Value

GEV_STATUS

Possible values are:

GEVLIB_OK
GEVLIB_ERROR_INVALID_HANDLE
GEVLIB_ERROR_PARAMETER_INVALID
GEVLIB_ERROR_ARG_INVALID

Replacement Function

GevQueryTransferStatus

Related Topics

Appendix D: Legacy Functions