mm_error_code_t

Updated: April 19, 2023

Error codes set by mm-renderer 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_MEDIA_DRM_EXPIRED_LICENSE,
    MMR_ERROR_PERMISSION,
    MMR_ERROR_COMMAND_FAILED,
    MMR_ERROR_COUNT
} mm_error_code_t;

Data:

MMR_ERROR_NONE

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

MMR_ERROR_UNKNOWN
An unexpected error has occurred.
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 is 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 error listed below.

MMR_ERROR_UNSUPPORTED_OPERATION

The operation is unsupported in the context that it was requested. For example, if you try to seek or to set the playback speed on media that don'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
The mm-renderer service can't open the source.
MMR_ERROR_MEDIA_CORRUPTED
The mm-renderer service found corrupt data on the media.
MMR_ERROR_OUTPUT_UNAVAILABLE
The mm-renderer service 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 (e.g., S-VIDEO, COMPOSITE, RGB, RGBHW, YPbPr).
MMR_ERROR_DRM_OPL_ANALOG_AUDIO
A DRM output protection mismatch on an audio ANALOG output (e.g., 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 (e.g., Wireless Display products such as WiDi and Miracast).
MMR_ERROR_DRM_OPL_RESERVED_LAST
An identifier marking the end-of-range for MMR_ERROR_DRM_OPL_* values.
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 (e.g., user prohibition, region mismatch).
MMR_ERROR_COMMAND_FAILED

Playback was interrupted by a failed API call. This error is used for an event but never returned as the error code from an API call.

MMR_ERROR_COUNT

An end-of-list identifier. This is not an error code itself, but it indicates the number of distinct error codes.

Library:

mmrndclient