VCEANCB_StartGrab

ImperX VCEANCB Functions

VCEANCB_StartGrab

The VCEANCB_StartGrab function starts grabbing stream from camera.

VCEANCB_Error VCEANCB_StartGrab (
  HANDLE hVCEANCB // Handle to card
  VCEANCB_GrabFrame_Callback lpfnCallback // User-defined CallBack function
  LPVOID lpUserData // User-defined data
);

Parameter:

hVCEANCB
[in] Handle to FrameLink card.
lpfnCallback
[in] User-defined call-back function to receive data from stream.
lpUserData
[in] User-defined data, which will be sent to lpfnCallback function.

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 VCE-PRO has not been successfully initialized.
VCEANCB_Err_notPrepared VCEANCB_PrepareGrab was not successfully called.
VCEANCB_Err_bufferBusy Grabbing buffers are busy.
VCEANCB_Err_UnknownError Error is unknown (possibly system error). To get extended error information, call VCEANCB_SystemLastError.

Remarks:

This function starts grabbing stream and calls User-defined callback function, when new frame ready. Note: You have to call VCEANCB_PrepareGrab() before start grabbing.

See also:

VCEANCB_PrepareGrab, VCEANCB_StopGrab, VCEANCB_GrabFrame_Callback