mm_error_code

Error codes set by Client API functions.

Synopsis:

#include <mm/renderer/types.h>
 
typedef enum mm_error_code {
      MMR_ERROR_NONE   
      MMR_ERROR_UNKNOWN   
      MMR_ERROR_INVALID_PARAMETER   
      MMR_ERROR_INVALID_STATE   
      MMR_ERROR_UNSUPPORTED_VALUE   
      MMR_ERROR_UNSUPPORTED_MEDIA_TYPE   
      MMR_ERROR_MEDIA_PROTECTED   
      MMR_ERROR_UNSUPPORTED_OPERATION   
      MMR_ERROR_READ   
      MMR_ERROR_WRITE   
      MMR_ERROR_MEDIA_UNAVAILABLE   
      MMR_ERROR_MEDIA_CORRUPTED   
      MMR_ERROR_OUTPUT_UNAVAILABLE   
      MMR_ERROR_NO_MEMORY   
      MMR_ERROR_RESOURCE_UNAVAILABLE   
      MMR_ERROR_MEDIA_DRM_NO_RIGHTS   
      MMR_ERROR_DRM_CORRUPTED_DATA_STORE   
      MMR_ERROR_DRM_OUTPUT_PROTECTION   
      MMR_ERROR_DRM_OPL_HDMI   
      MMR_ERROR_DRM_OPL_DISPLAYPORT   
      MMR_ERROR_DRM_OPL_DVI   
      MMR_ERROR_DRM_OPL_ANALOG_VIDEO   
      MMR_ERROR_DRM_OPL_ANALOG_AUDIO   
      MMR_ERROR_DRM_OPL_TOSLINK   
      MMR_ERROR_DRM_OPL_SPDIF   
      MMR_ERROR_DRM_OPL_BLUETOOTH   
      MMR_ERROR_DRM_OPL_WIRELESSHD   
      MMR_ERROR_DRM_OPL_WIFI_DIRECT   
      MMR_ERROR_DRM_OPL_RESERVED_LAST = MMR_ERROR_DRM_OPL_WIRELESSHD + 4   
      MMR_ERROR_MEDIA_DRM_EXPIRED_LICENSE   
      MMR_ERROR_PERMISSION   
      MMR_ERROR_COMMAND_FAILED   
      MMR_ERROR_COUNT   
} mm_error_code_t;

Since:

BlackBerry 10.0.0

Data:

MMR_ERROR_NONE
No error has occurred.

This error code is used for the EOF event but is never returned as the error code from an API call.

MMR_ERROR_UNKNOWN
An unexpected error.
MMR_ERROR_INVALID_PARAMETER
An invalid parameter, such as an invalid output ID or a seek string that's incorrectly formatted or out of range.

MMR_ERROR_INVALID_STATE
An illegal operation given the context state, such as an attempt to play or seek while no input is attached, to change the playlist when playback was stopped, or to access the context after it's been destroyed.

MMR_ERROR_UNSUPPORTED_VALUE
An unrecognized input or output type or an out-of-range speed setting.
MMR_ERROR_UNSUPPORTED_MEDIA_TYPE
An unrecognized data format.
MMR_ERROR_MEDIA_PROTECTED
The file is DRM-protected and either it uses an unsupported DRM scheme or there's a DRM error not corresponding to any of the errors listed below.
MMR_ERROR_UNSUPPORTED_OPERATION
An operation that is unsupported for the current piece of media being played.

This error is returned if you try to seek or to set the playback speed on media that doesn't allow it, or you try to attach an output after attaching the input but the underlying media doesn't support that action sequence.

MMR_ERROR_READ
An I/O error at the source.
MMR_ERROR_WRITE
An I/O error at the sink.
MMR_ERROR_MEDIA_UNAVAILABLE
mm-renderer can't open the source.
MMR_ERROR_MEDIA_CORRUPTED
mm-renderer found corrupt data on the media.
MMR_ERROR_OUTPUT_UNAVAILABLE
mm-renderer can't write to the output (possibly because the output URL or type doesn't match any supported sink).
MMR_ERROR_NO_MEMORY
Insufficient memory to perform the requested operation.
MMR_ERROR_RESOURCE_UNAVAILABLE
A required resource such as an encoder or an output feed is presently unavailable.
MMR_ERROR_MEDIA_DRM_NO_RIGHTS
The client lacks the rights to play the file.
MMR_ERROR_DRM_CORRUPTED_DATA_STORE
The DRM data store is corrupted.
MMR_ERROR_DRM_OUTPUT_PROTECTION
A DRM output protection mismatch on an unspecified output.
MMR_ERROR_DRM_OPL_HDMI
A DRM output protection mismatch on an HDMI output.
MMR_ERROR_DRM_OPL_DISPLAYPORT
A DRM output protection mismatch on a DISPLAYPORT output.
MMR_ERROR_DRM_OPL_DVI
A DRM output protection mismatch on a DVI output.
MMR_ERROR_DRM_OPL_ANALOG_VIDEO
A DRM output protection mismatch on a video ANALOG output (for example, S-VIDEO, COMPOSITE, RGB, RGBHW, YPbPr).
MMR_ERROR_DRM_OPL_ANALOG_AUDIO
A DRM output protection mismatch on an audio ANALOG output (for example, HEADPHONE, SPEAKER OUT).
MMR_ERROR_DRM_OPL_TOSLINK
A DRM output protection mismatch on a TOSLINK output.
MMR_ERROR_DRM_OPL_SPDIF
A DRM output protection mismatch on an S/PDIF output.
MMR_ERROR_DRM_OPL_BLUETOOTH
A DRM output protection mismatch on a BLUETOOTH output.
MMR_ERROR_DRM_OPL_WIRELESSHD
A DRM output protection mismatch on a WIRELESSHD output.
MMR_ERROR_DRM_OPL_WIFI_DIRECT
A DRM output protection mismatch on a WIFI DIRECT output (for example, Wireless Display products such as WiDi and Miracast).
MMR_ERROR_DRM_OPL_RESERVED_LAST
MMR_ERROR_MEDIA_DRM_EXPIRED_LICENSE
A license for the DRM file was found but has expired, either because the play count has been depleted or the end time has passed.
MMR_ERROR_PERMISSION
A playback permission error (for example, user prohibition, region mismatch).
MMR_ERROR_COMMAND_FAILED
Playback interrupted by a failed API call.

This error code is used for an event but never returned as the error code from an API call.

MMR_ERROR_COUNT
An end-of-list identifier.

Also indicates the number of distinct error codes.

Library:

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

Description:

The enumerated type mm_error_code_t defines the error codes returned by Client API functions.