camera_get_postview

Retrieve postview buffers from the camera.

Synopsis:

#include <camera/camera_api.h>

camera_error_t camera_get_postview_buffers(camera_handle_t handle,                 
                                           camera_eventkey_t key,                 
                                           camera_buffer_t *inbuffer,                 
                                           camera_buffer_t *outbuffer)

Since:

BlackBerry 10.0.0

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_postview_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 (For the qcc command, use the -l camapi option to link against this library)

Description:

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

Postview events are enabled using camera_enable_postview_event(). Use the camera_return_buffer() when you are finished processing a buffer. For more information about event mode, see scope="peer">About event mode. 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 outlined in Camera resource management. 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: