CAMSubmitTargetSurface

Syntax

#include <cafe/camera/camera.h>

int CAMSubmitTargetSurface(CAMHandle hCam, CAMSurface *surface);

Parameters

hCam Handle returned from CAMInit.
surface Pointer to a surface of type CAMSurface.

Return Values

A value of zero indicates success and any other value the type of error that was encountered.

The following error codes can be returned.

CAMERA_ERROR_INVALID_HANDLE hCam handle is invalid.
CAMERA_ERROR_INVALID_ARG One or more of the arguments are invalid.
CAMERA_ERROR_NOT_READY Camera is in a close state.
CAMERA_ERROR_QUEUE_FULL Camera target surface queue is full.
CAMERA_ERROR_NONE No error

Description

Calling this function will submit a decode target surface to the camera driver. The driver adds this surface to an internal FIFO and the call returns without any further processing. The driver has a thread that dequeues the surface from the FIFO, fills it with the decompressed video frame data, and fires the CAMEventHandler callback to inform the application that a video frame is ready for rendering.

Do Not Call From

Background Do not call this function from the background.

See Also

CAMHandle
CAMInit
CAMEventHandler

Revision History

2013/05/08 Automated cleanup pass.
2011/10/24 Initial version.


CONFIDENTIAL