Machine Vision Camera SDK (C) Developer Guide
Return Value
Return MV_OK(0) on success, and return Error Code on failure.
Remarks
● You can call this API to clear the needless images in the buffer even when the streaming is in
progress.
● You can call this API to clear history data when the continuous mode is switched to the trigger
mode.
4.4.2 MV_CC_FreeImageBuffer
Release image buffer (this API is used to release the image buffer, which is no longer used, and it
should be used with API: MV_CC_GetImageBuffer).
API Definition
int MV_CC_FreeImageBuffer(
void
*handle,
MV_FRAME_OUT
*pFrame,
);
Parameters
handle
[IN] Device handle, which is returned by MV_CC_CreateHandle or
MV_CC_CreateHandleWithoutLog .
pFrame
[IN] Image data and information
Return Value
Return MV_OK(0) on success, and return Error Code on failure.
Remarks
● This API and MV_CC_GetImageBuffer should be called in pairs, before calling
MV_CC_GetImageBuffer to get image data pFrame, you should call MV_CC_FreeImageBuffer to
release the permission.
● Compared with API MV_CC_GetOneFrameTimeout , this API has higher efficiency of image
acquisition. The max. number of nodes can be outputted is same as the "nNum" of API
MV_CC_SetImageNodeNum , default value is 1.
● This API is not supported by CameraLink device.
● This API is supported by both USB3 vision camera and GigE camera.
90
