Camera Library Referencecamera_api.h Parent topic: camera_api.h

camera_get_video_buffers()

Retrieve video buffers from the camera

Synopsis:

#include <camera/camera_api.h>
camera_error_t camera_get_video_buffers(camera_handle_t handle,
                                        camera_eventkey_t key,
                                        camera_buffer_t *inbuffer,
                                        camera_buffer_t *outbuffer)

Arguments:

handle
The handle returned by a call to the camera_open() function.
key
The key value that was returned by a call to the camera_enable_video_event() function.
inbuffer
A pointer to the input camera_buffer_t struct returned by the camera.
outbuffer
A pointer to the output camera_buffer_t struct returned by the camera.

Library:

libcamapi

Description:

Use this function to retrieve buffers with video data. Only call this function after receiving a video event.

Video events are enabled using camera_enable_video_event(). Use the camera_return_buffer() when you are finished processing a buffer. For more information about event mode, see "Event mode" in the Camera Library Developer's Guide. For more information about when inbuffer and outbuffer are used, see camera_eventmode_t.

Note:

It is important that your application follows the guidelines for resource management described in "Resource management" of the Camera Library Developer's Guide. If you do not observe these guidelines, your application is at risk of crashing due to memory access errors when resource arbitration is performed by the operating system.

Returns:

CAMERA_EOK when the function successfully completes, otherwise another camera_error_t value that provides the reason that the call failed.

Parent topic: camera_api.h