camera_error_t

Error codes for the Camera library.

Synopsis:

#include <camera/camera_api.h>
 
typedef enum {
      CAMERA_EOK = EOK   
      CAMERA_EAGAIN = EAGAIN   
      CAMERA_EINVAL = EINVAL   
      CAMERA_ENODEV = ENODEV   
      CAMERA_EMFILE = EMFILE   
      CAMERA_EBADF = EBADF   
      CAMERA_EACCESS = EACCES   
      CAMERA_EBADR = EBADR   
      CAMERA_ENODATA = ENODATA   
      CAMERA_ENOENT = ENOENT   
      CAMERA_ENOMEM = ENOMEM   
      CAMERA_EOPNOTSUPP = EOPNOTSUPP   
      CAMERA_ETIMEDOUT = ETIMEDOUT   
      CAMERA_EALREADY = EALREADY   
      CAMERA_EBUSY = EBUSY   
      CAMERA_ENOSPC = ENOSPC   
      CAMERA_EUNINIT = 0x1000   
      CAMERA_EREGFAULT   
      CAMERA_EMICINUSE   
      CAMERA_EDESKTOPCAMERAINUSE   
      CAMERA_EPOWERDOWN   
      CAMERA_3ALOCKED   
      CAMERA_EVIEWFINDERFROZEN   
      CAMERA_EOVERFLOW   
      CAMERA_ETHERMALSHUTDOWN   
} camera_error_t;

Since:

BlackBerry 10.0.0

Data:

CAMERA_EOK
The function call to the camera completed successfully.
CAMERA_EAGAIN
The function call failed due to a temporary unavailable condition.

Try to call the function again.

CAMERA_EINVAL
The function call failed because of an invalid argument.
CAMERA_ENODEV
The function call failed because the specified camera was not found.
CAMERA_EMFILE
The function call failed because of a file table overflow.
CAMERA_EBADF
The function call failed because an invalid camera_handle_t value was used.
CAMERA_EACCESS
The function call failed because the necessary permissions to access the camera are not available.
CAMERA_EBADR
The function call failed because an invalid file descriptor was used.
CAMERA_ENODATA
The function call failed because the requested data does not exist.
CAMERA_ENOENT
The function call failed because the specified file or directory does not exist.
CAMERA_ENOMEM
The function call failed because memory allocation failed.
CAMERA_EOPNOTSUPP
The function call failed because the requested operation is not supported.
CAMERA_ETIMEDOUT
The function call failed due to communication problem or time-out with the camera.
CAMERA_EALREADY
The function call failed because an operation on the camera is already in progress.

In addition, this error can indicate that a call could not be completed because it was invalid or completed already. For example, if you called the camera_stop_video() function but the camera had already stopped recording video, this error code would be returned.

CAMERA_EBUSY
The function call failed because the camera is busy.

Typically you receive this error when you try to open a camera while the camera or its required resources are in use.

CAMERA_ENOSPC
The function call failed because the disk is full.

This typically happens when you are trying to start a video recording and less than the system-reserved amount of disk space remains.

CAMERA_EUNINIT
The function call failed because the Camera library has not been initialized.
CAMERA_EREGFAULT
The function call failed because the registration of a callback failed.
CAMERA_EMICINUSE
The function call failed because the microphone is already in use.
CAMERA_EDESKTOPCAMERAINUSE
The function call failed because the operation cannot be completed while the camera CAMERA_UNIT_DESKTOP is in use.
CAMERA_EPOWERDOWN
The function call failed because the camera is in the power down state.

Since: BlackBerry 10.2.0

CAMERA_3ALOCKED
The function call failed because a 3A lock is active.

Since: BlackBerry 10.3.0

CAMERA_EVIEWFINDERFROZEN
The function call failed because the viewfinder freeze flag was set on the device for privacy reasons.

Since: BlackBerry 10.3.0

CAMERA_EOVERFLOW
The function call failed due to an internal overflow.

Since: BlackBerry 10.3.0

CAMERA_ETHERMALSHUTDOWN
The function call failed because the camera is in power down state to prevent damage due to excessive heat.

Since: BlackBerry 10.3.0

Library:

libcamapi (For the qcc command, use the -l camapi option to link against this library)

Description:

If you receive an error code which is not enumerated in this list, consult the system-wide list of error codes in errno.h.

Last modified: 2014-06-24



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus