GEV_STATUS GevQueryTransferStatus

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

Description

This function returns status information about the frame transfer currently in progress. The total number of buffers associated with the transfer are returned alongwith the number of filled buffers, the number of free buffers available, and the number of buffers sent to trash The buffer cycling mode is also returned. If the buffer cycling mode is set to Synchronous, any frames from the camera that arrive when no free buffers are available are sent to trash (not stored) and the number of trashed buffers is incremented. This information can be used to tell if the application is falling behind in its handling of frames from the camera. 

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