VCEANCB_GetDIB

The VCEANCB_GetDIB function generates Device Independent Bitmap (DIB) from snapped frame.

VCEANCB_Error VCEANCB_GetDIB (
  HANDLE hVCEANCB, // Handle to card
  HGLOBAL* phDIB // Pointer to DIB
);

Parameter:

hVCEANCB

[in] Handle to FrameLink card.

phDIB

[out] Pointer to DIB handle.

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 or phDIB pointer is bad (possibly NULL).
VCEANCB_Err_notGrabbed	VCEANCB_SnapFrame was not called.
VCEANCB_Err_bufferBusy	Snapping buffers are busy.
VCEANCB_Err_notSupported	Unsupported camera operation mode.
VCEANCB_Err_noMemory	Not enough memory.

Remarks:

VCEANCB_GetDIB function generates Device Independed Bitmap explained in Device-Independent Bitmaps section of Windows® GDI. To free memory used by DIB call VCEANCB_ReleaseDIB.

See also:

VCEANCB_SnapFrame, VCEANCB_ReleaseDIB, VCEANCB_DrawDIB, VCEANCB_SaveDIBToFile