Get a free video capture buffer when bringing in video from an external source
#include <vcapture/capture.h>
#define capture_get_free_buffer( context, timeout, flags ) \ capture_get_frame( context, timeout, (flags) | CAPTURE_FLAG_FREE_BUFFER )
This macro returns the index to a free buffer. Once your application populates the buffer and sets the appropriate capture properties, the client application calls capture_put_buffer() to place the capture buffer in the video capture stream. Use another thread to call capture_get_frame()) to return a processed frame (for example, the frame is scaled or deinterlaced).
Refer to capture_get_frame() for full description for this function.