Specifications

sharpVISION™ Camera

sharpVISION™ VISION SDK

3.3.3. SvQueueOneFrame

SV_ERROR SvQueueOneFrame(SV_HANDLE hCamera, PSV_FRAME pFrame,

SV_AsyncCallback pfnCallback, unsigned long nFlags, void *pUser, unsigned

long nUserData)

Return values

SVC_SUCCESS if successful, otherwise

SVC_INVALIDHANDLE, if the camera handle is not valid.

SVC_BUFFERTOOSMALL, if the frame buffer is too small for the image.

SVC_FIREWIREFAULT, if an internal error occurred while calling the firewire driver.

Parameters

hCamera

Specifies the handle to an open camera.

pFrame

Specifies the pointer to the frame structure.

pfnCallback

Specifies the pointer to the callback routine. The routine is called by the driver when the

settings are changed. See SC_AsynchCallback.

nFlags

Specifies the flags. See Appendix.

pUser

Specifies the pointer to user data. The pointer is passed to the callback rouitne when it's

called.

nUserData

Specifies the value of user data.

Remarks

This functions queues a frame buffer and returns immediately. It's used for asynchronous

acquisitions. When the frame has been captured the pfnCallback routine is called. The frame

structure and the associated data buffer must persist until the frame has been grabbed.