mm_error_code_t

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

Page updated: March 12, 2026