VCEANCB_SnapFrame

ImperX VCEANCB Functions

VCEANCB_SnapFrame

The VCEANCB_SnapFrame function snaps one frame from camera.

VCEANCB_Error VCEANCB_SnapFrame (
  HANDLE hVCEANCB // Handle to card
);

Parameter:

hVCEANCB
[in] Handle to FrameLink card.

Return values:

If function succeeds, the return value is VCEANCB_Err_Success.

If function fails, the return value can be one of the following values.

VCEANCB_Err_badArgument hVCEANCB handle is bad (possibly NULL).
VCEANCB_Err_notInitialized FrameLink has not been successfully initialized.
VCEANCB_Err_notPrepared VCEANCB_Prepare was not successfully called.
VCEANCB_Err_bufferBusy Snapping buffers are busy.
VCEANCB_Err_CameraIsNotConnected Camera is not connected.
VCEANCB_Err_lostContact Contact with camera was lost during snapping.
VCEANCB_Err_UnknownError Error is unknown (possibly system error). To get extended error information, call VCEANCB_SystemLastError.

Remarks:

This function only snaps one frame to internal buffer, to get image call VCEANCB_GetDIB function.

Note: You have to call VCEANCB_Prepare() function, before start snap.

See also:

VCEANCB_Prepare,VCEANCB_GetDIB, VCEANCB_LockBuffer