The Media Format APIs provides functions for specify video or audio information.

Required Header

#include <media_format.h>

Functions
int	media_format_create (media_format_h *fmt)
	Creates a media format.
int	media_format_get_type (media_format_h fmt, media_format_type_e *formattype)
	Gets format type of media format.
int	media_format_get_container_mime (media_format_h fmt, media_format_mimetype_e *mimetype)
	Gets container MIME type of media format.
int	media_format_get_text_info (media_format_h fmt, media_format_mimetype_e mimetype, media_format_text_type_e type)
	Gets text track information of media format.
int	media_format_get_video_info (media_format_h fmt, media_format_mimetype_e mimetype, int width, int height, int avg_bps, int *max_bps)
	Gets video information of media format.
int	media_format_get_audio_info (media_format_h fmt, media_format_mimetype_e mimetype, int channel, int samplerate, int bit, int *avg_bps)
	Gets audio information of media format.
int	media_format_get_audio_aac_type (media_format_h fmt, bool *is_adts)
	Gets audio aac type of media format.
int	media_format_get_audio_aac_header_type (media_format_h fmt, media_format_aac_header_type_e *aac_header_type)
	Gets audio aac header type of media format.
int	media_format_get_video_frame_rate (media_format_h fmt, int *frame_rate)
	Gets video frame rate of media format.
int	media_format_set_container_mime (media_format_h fmt, media_format_mimetype_e mimetype)
	Sets container MIME type of media format.
int	media_format_set_text_mime (media_format_h fmt, media_format_mimetype_e mimetype)
	Sets text MIME type of media format.
int	media_format_set_text_type (media_format_h fmt, media_format_text_type_e type)
	Sets text type of media format.
int	media_format_set_video_mime (media_format_h fmt, media_format_mimetype_e mimetype)
	Sets video MIME type of media format.
int	media_format_set_video_width (media_format_h fmt, int width)
	Sets video width of media format.
int	media_format_set_video_height (media_format_h fmt, int height)
	Sets video height of media format.
int	media_format_set_video_avg_bps (media_format_h fmt, int avg_bps)
	Sets video avg_bps of media format.
int	media_format_set_video_max_bps (media_format_h fmt, int max_bps)
	Sets video max_bps of media format.
int	media_format_set_video_frame_rate (media_format_h fmt, int frame_rate)
	Sets video frame rate of media format.
int	media_format_set_audio_mime (media_format_h fmt, media_format_mimetype_e mimetype)
	Sets audio MIME type of media format.
int	media_format_set_audio_channel (media_format_h fmt, int channel)
	Sets audio channel of media format.
int	media_format_set_audio_samplerate (media_format_h fmt, int samplerate)
	Sets audio samplerate of media format.
int	media_format_set_audio_bit (media_format_h fmt, int bit)
	Sets audio bit of media format.
int	media_format_set_audio_avg_bps (media_format_h fmt, int avg_bps)
	Sets audio avg_bps of media format.
int	media_format_set_audio_aac_type (media_format_h fmt, bool is_adts)
	Sets audio aac type of media format.
int	media_format_set_audio_aac_header_type (media_format_h fmt, media_format_aac_header_type_e aac_header_type)
	Sets audio aac header type of media format.
int	media_format_ref (media_format_h fmt)
	Increases reference count of media_format_h object.
int	media_format_unref (media_format_h fmt)
	Decreases reference count of media_format_h object.
int	media_format_is_writable (media_format_h fmt, bool *is_writable)
	Checks whether the media_format_h is writable or not.
int	media_format_make_writable (media_format_h fmt, media_format_h *out_fmt)
	Returns a writable copy of media_format_h.
int	media_format_set_extra (media_format_h fmt, void *extra_data)
	Sets extra data of media format.
int	media_format_get_extra (media_format_h fmt, void **extra_data)
	Gets extra data of media format.
int	media_format_set_audio_channel_mask (media_format_h fmt, uint64_t channel_mask)
	Sets audio channel mask of media format.
int	media_format_get_audio_channel_mask (media_format_h fmt, uint64_t *channel_mask)
	Gets audio channel mask of media format.
int	media_format_is_little_endian (media_format_h fmt, bool *is_little_endian)
	Checks whether the given media format is little endian.
int	media_format_get_audio_bit_depth (media_format_h fmt, int *bit_depth)
	Gets the number of bits of information in digital audio using pulse-code modulation (PCM).
int	media_format_channel_positions_from_mask (media_format_h fmt, uint64_t channel_mask, media_format_channel_position_e **positions)
	Converts the channels in the channel_mask to a positions array.
int	media_format_channel_positions_to_mask (media_format_h fmt, const media_format_channel_position_e positions, uint64_t channel_mask_out)
	Converts the positions array to a bitmask.
Typedefs
typedef struct media_format_s *	media_format_h
	Media Format handle type.

Typedef Documentation

typedef struct media_format_s* media_format_h

Media Format handle type.

Since :: 2.3.1

Enumeration Type Documentation

enum media_format_aac_header_type_e

Enumeration for media format aac header type.

Since :: 3.0

Enumerator:

MEDIA_FORMAT_AAC_HEADER_NONE	media format aac header type is RAW, no header
MEDIA_FORMAT_AAC_HEADER_ADTS	media format aac header type is ADTS header
MEDIA_FORMAT_AAC_HEADER_ADIF	media format aac header type is ADIF header
MEDIA_FORMAT_AAC_HEADER_UNKNOWN	media format aac header type is UNKNOWN

enum media_format_channel_position_e

Enumeration for audio channel positions.

Since :: 5.5

Enumerator:

MEDIA_FORMAT_CHANNEL_POSITION_NONE	Used for position-less channels
MEDIA_FORMAT_CHANNEL_POSITION_MONO	Used for mono without direction
MEDIA_FORMAT_CHANNEL_POSITION_INVALID	Used for invalid position
MEDIA_FORMAT_CHANNEL_POSITION_FRONT_LEFT	Front left
MEDIA_FORMAT_CHANNEL_POSITION_FRONT_RIGHT	Front Right
MEDIA_FORMAT_CHANNEL_POSITION_FRONT_CENTER	Front Center
MEDIA_FORMAT_CHANNEL_POSITION_LFE1	Low-frequency effects 1 (subwoofer)
MEDIA_FORMAT_CHANNEL_POSITION_REAR_LEFT	Rear left
MEDIA_FORMAT_CHANNEL_POSITION_REAR_RIGHT	Rear right
MEDIA_FORMAT_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER	Front left of center
MEDIA_FORMAT_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER	Front right of center
MEDIA_FORMAT_CHANNEL_POSITION_REAR_CENTER	Rear center
MEDIA_FORMAT_CHANNEL_POSITION_LFE2	Low-frequency effects 2 (subwoofer)
MEDIA_FORMAT_CHANNEL_POSITION_SIDE_LEFT	Side left
MEDIA_FORMAT_CHANNEL_POSITION_SIDE_RIGHT	Side Right
MEDIA_FORMAT_CHANNEL_POSITION_TOP_FRONT_LEFT	Top front left
MEDIA_FORMAT_CHANNEL_POSITION_TOP_FRONT_RIGHT	Top front right
MEDIA_FORMAT_CHANNEL_POSITION_TOP_FRONT_CENTER	Top front center
MEDIA_FORMAT_CHANNEL_POSITION_TOP_CENTER	Top center
MEDIA_FORMAT_CHANNEL_POSITION_TOP_REAR_LEFT	Top rear left
MEDIA_FORMAT_CHANNEL_POSITION_TOP_REAR_RIGHT	Top rear right
MEDIA_FORMAT_CHANNEL_POSITION_TOP_SIDE_LEFT	Top side left
MEDIA_FORMAT_CHANNEL_POSITION_TOP_SIDE_RIGHT	Top side right
MEDIA_FORMAT_CHANNEL_POSITION_TOP_REAR_CENTER	Top rear center
MEDIA_FORMAT_CHANNEL_POSITION_BOTTOM_FRONT_CENTER	Bottom front center
MEDIA_FORMAT_CHANNEL_POSITION_BOTTOM_FRONT_LEFT	Bottom front left
MEDIA_FORMAT_CHANNEL_POSITION_BOTTOM_FRONT_RIGHT	Bottom front right
MEDIA_FORMAT_CHANNEL_POSITION_WIDE_LEFT	Wide left (between front left and side left)
MEDIA_FORMAT_CHANNEL_POSITION_WIDE_RIGHT	Wide right (between front right and side right)
MEDIA_FORMAT_CHANNEL_POSITION_SURROUND_LEFT	Surround left (between rear left and side left)
MEDIA_FORMAT_CHANNEL_POSITION_SURROUND_RIGHT	Surround right (between rear right and side right)

enum media_format_color_model_e

Enumeration for media color model.

Since :: 2.3.1

Enumerator:

MEDIA_COLOR_MODEL_NONE	media format color model is NONE
MEDIA_COLOR_MODEL_RGB	media format color model is RGB
MEDIA_COLOR_MODEL_YUV	media format color model is YUV

enum media_format_data_type_e

Enumeration for media format data type.

Since :: 2.3.1

Enumerator:

MEDIA_FORMAT_ENCODED	media format data type is encoded type
MEDIA_FORMAT_RAW	media format data type is raw type

enum media_format_error_e

Enumerations of media format error.

Since :: 2.3.1

Enumerator:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation
MEDIA_FORMAT_ERROR_FILE_NO_SPACE_ON_DEVICE	No space left on device

enum media_format_mimetype_e

Enumeration for media format MIME type.

Since :: 2.3.1

Enumerator:

MEDIA_FORMAT_L16	media format mime type is L16, AUDIO
MEDIA_FORMAT_ALAW	media format mime type is ALAW, AUDIO
MEDIA_FORMAT_ULAW	media format mime type is ULAW, AUDIO
MEDIA_FORMAT_AMR	media format mime type is AMR, AUDIO, indicates MEDIA_FORMAT_AMR_NB (Since 3.0)
MEDIA_FORMAT_AMR_NB	media format mime type is AMR_NB, AUDIO , (Since 3.0)
MEDIA_FORMAT_AMR_WB	media format mime type is AMR_WB, AUDIO, (Since 3.0)
MEDIA_FORMAT_G729	media format mime type is G729, AUDIO
MEDIA_FORMAT_AAC	media format mime type is AAC, AUDIO, indicates MEDIA_FORMAT_AAC_LC (Since 3.0)
MEDIA_FORMAT_AAC_LC	media format mime type is AAC_LC, AUDIO, (Since 3.0)
MEDIA_FORMAT_AAC_HE	media format mime type is AAC_HE, AUDIO, (Since 3.0)
MEDIA_FORMAT_AAC_HE_PS	media format mime type is AAC_HE_PS, AUDIO, (Since 3.0)
MEDIA_FORMAT_MP3	media format mime type is MP3, AUDIO
MEDIA_FORMAT_MP2	media format mime type is MP23, AUDIO, (Since 4.0)
MEDIA_FORMAT_VORBIS	media format mime type is VORBIS, AUDIO, (Since 3.0)
MEDIA_FORMAT_FLAC	media format mime type is FLAC, AUDIO, (Since 3.0)
MEDIA_FORMAT_WMAV1	media format mime type is WMAV1, AUDIO, (Since 3.0)
MEDIA_FORMAT_WMAV2	media format mime type is WMAV2, AUDIO, (Since 3.0)
MEDIA_FORMAT_WMAPRO	media format mime type is WMAVPRO, AUDIO, (Since 3.0)
MEDIA_FORMAT_WMALSL	media format mime type is WMAVLSL, AUDIO, (Since 3.0)
MEDIA_FORMAT_AC3	media format mime type is AC3, AUDIO, (Since 4.0)
MEDIA_FORMAT_EAC3	media format mime type is EAC3, AUDIO, (Since 4.0)
MEDIA_FORMAT_DTS	media format mime type is DTS, AUDIO, (Since 4.0)
MEDIA_FORMAT_OPUS	media format mime type is OPUS, AUDIO, (Since 4.0)
MEDIA_FORMAT_PCM	media format mime type is PCM, AUDIO, indicates MEDIA_FORMAT_PCM_S16LE (Since 3.0)
MEDIA_FORMAT_PCM_S16LE	media format mime type is PCM signed 16-bit little-endian, AUDIO, (Since 3.0)
MEDIA_FORMAT_PCM_S24LE	media format mime type is PCM signed 24-bit little-endian, AUDIO, (Since 3.0)
MEDIA_FORMAT_PCM_S32LE	media format mime type is PCM signed 32-bit little-endian, AUDIO, (Since 3.0)
MEDIA_FORMAT_PCM_S16BE	media format mime type is PCM signed 16-bit big-endian, AUDIO, (Since 3.0)
MEDIA_FORMAT_PCM_S24BE	media format mime type is PCM signed 24-bit big-endian, AUDIO, (Since 3.0)
MEDIA_FORMAT_PCM_S32BE	media format mime type is PCM signed 32-bit big-endian, AUDIO, (Since 3.0)
MEDIA_FORMAT_PCM_F32LE	media format mime type is PCM 32-bit floating point little-endian, AUDIO, (Since 3.0)
MEDIA_FORMAT_PCM_F32BE	media format mime type is PCM 32-bit floating point big-endian, AUDIO, (Since 3.0)
MEDIA_FORMAT_PCM_U16LE	media format mime type is PCM unsigned 16-bit little-endian, AUDIO, (Since 4.0)
MEDIA_FORMAT_PCM_U24LE	media format mime type is PCM unsigned 24-bit little-endian, AUDIO, (Since 4.0)
MEDIA_FORMAT_PCM_U32LE	media format mime type is PCM unsigned 32-bit little-endian, AUDIO, (Since 4.0)
MEDIA_FORMAT_PCM_U16BE	media format mime type is PCM unsigned 16-bit big-endian, AUDIO, (Since 4.0)
MEDIA_FORMAT_PCM_U24BE	media format mime type is PCM unsigned 24-bit big-endian, AUDIO, (Since 4.0)
MEDIA_FORMAT_PCM_U32BE	media format mime type is PCM unsigned 32-bit big-endian, AUDIO, (Since 4.0)
MEDIA_FORMAT_PCMA	media format mime type is PCM A-law, AUDIO
MEDIA_FORMAT_PCMU	media format mime type is PCM U-law, AUDIO
MEDIA_FORMAT_H261	media format mime type is H261, VIDEO
MEDIA_FORMAT_H263	media format mime type is H263, VIDEO
MEDIA_FORMAT_H263P	media format mime type is H263P, VIDEO
MEDIA_FORMAT_H263_BLP	media format mime type is H263 Baseline Profile, VIDEO, (Since 3.0)
MEDIA_FORMAT_H263_H320_CEP	media format mime type is H263 H.320 Coding Efficiency Profile, VIDEO, (Since 3.0)
MEDIA_FORMAT_H263_BCP	media format mime type is H263 Backward-Compatibility Profile, VIDEO, (Since 3.0)
MEDIA_FORMAT_H263_ISW2P	media format mime type is H263 the version 2 Interactive and Streaming Wireless Profile, VIDEO, (Since 3.0)
MEDIA_FORMAT_H263_ISW3P	media format mime type is H263 the version 3 Interactive and Streaming Wireless Profile, VIDEO, (Since 3.0)
MEDIA_FORMAT_H263_CHCP	media format mime type is H263 Conversation High Compression Profile, VIDEO, (Since 3.0)
MEDIA_FORMAT_H263_C_INTERNETP	media format mime type is H263 Conversational Internet Profile, VIDEO, (Since 3.0)
MEDIA_FORMAT_H263_C_INTERLACEP	media format mime type is H263 Conversational Interlace Profile, VIDEO, (Since 3.0)
MEDIA_FORMAT_H263_HLP	media format mime type is H263 High Latency Profile, VIDEO, (Since 3.0)
MEDIA_FORMAT_H264_SP	media format mime type is H264 baseline profile, VIDEO
MEDIA_FORMAT_H264_MP	media format mime type is H264 main profile, VIDEO
MEDIA_FORMAT_H264_HP	media format mime type is H264 high profile, VIDEO
MEDIA_FORMAT_H264_EXTP	media format mime type is H264 Extended Profile, VIDEO (Since 3.0)
MEDIA_FORMAT_H264_H10P	media format mime type is H264 High10 Profile, VIDEO (Since 3.0)
MEDIA_FORMAT_H264_H422P	media format mime type is H264 High422 Profile, VIDEO (Since 3.0)
MEDIA_FORMAT_H264_H444P	media format mime type is H264 High444 Profile, VIDEO (Since 3.0)
MEDIA_FORMAT_H264_C444P	media format mime type is H264 CAVLC444 Profile, VIDEO (Since 3.0)
MEDIA_FORMAT_MJPEG	media format mime type is MJPEG, VIDEO
MEDIA_FORMAT_MPEG1	media format mime type is MPEG1, VIDEO
MEDIA_FORMAT_MPEG2_SP	media format mime type is MPEG2 simple profile, VIDEO
MEDIA_FORMAT_MPEG2_MP	media format mime type is MPEG2 main profile, VIDEO
MEDIA_FORMAT_MPEG2_HP	media format mime type is MPEG2 high profile, VIDEO
MEDIA_FORMAT_MPEG4_SP	media format mime type is MPEG4 simple profile, VIDEO
MEDIA_FORMAT_MPEG4_ASP	media format mime type is MPEG4 advanced simple profile, VIDEO
MEDIA_FORMAT_HEVC	media format mime type is HEVC, VIDEO, (Since 3.0)
MEDIA_FORMAT_HEVC_MP	media format mime type is HEVC Main Profile, VIDEO, (Since 3.0)
MEDIA_FORMAT_HEVC_M10P	media format mime type is HEVC Main10 Profile, VIDEO, (Since 3.0)
MEDIA_FORMAT_VP8	media format mime type is VP8, VIDEO, (Since 3.0)
MEDIA_FORMAT_VP9	media format mime type is VP9, VIDEO, (Since 3.0)
MEDIA_FORMAT_VC1	media format mime type is VC1, VIDEO, (Since 3.0)
MEDIA_FORMAT_DIVX4	media format mime type is DIVX4, VIDEO, (Since 4.0)
MEDIA_FORMAT_DIVX5	media format mime type is DIVX5, VIDEO, (Since 4.0)
MEDIA_FORMAT_XVID	media format mime type is XVID, VIDEO, (Since 4.0)
MEDIA_FORMAT_AV1	media format mime type is AV1, VIDEO, (Since 6.0)
MEDIA_FORMAT_I420	media format mime type is I420, VIDEO
MEDIA_FORMAT_NV12	media format mime type is NV12, VIDEO
MEDIA_FORMAT_NV12T	media format mime type is NV12T, VIDEO
MEDIA_FORMAT_YV12	media format mime type is YV12, VIDEO
MEDIA_FORMAT_NV21	media format mime type is NV21, VIDEO
MEDIA_FORMAT_NV16	media format mime type is NV16, VIDEO
MEDIA_FORMAT_YUYV	media format mime type is YUYV, VIDEO
MEDIA_FORMAT_UYVY	media format mime type is UYVY, VIDEO
MEDIA_FORMAT_422P	media format mime type is 422P, VIDEO
MEDIA_FORMAT_RGB565	media format mime type is RGB565, VIDEO
MEDIA_FORMAT_RGB888	media format mime type is RGB888, VIDEO
MEDIA_FORMAT_RGBA	media format mime type is RGBA, VIDEO
MEDIA_FORMAT_ARGB	media format mime type is ARGB, VIDEO
MEDIA_FORMAT_BGRA	media format mime type is BGRA, VIDEO, (Since 3.0)
MEDIA_FORMAT_Y8	media format mime type is Y8, VIDEO, (Since 5.5)
MEDIA_FORMAT_CONTAINER_MP4	media format mime type is MP4 container, VIDEO, (Since 3.0)
MEDIA_FORMAT_CONTAINER_AVI	media format mime type is AVI container, VIDEO, (Since 3.0)
MEDIA_FORMAT_CONTAINER_MPEG2TS	media format mime type is MPEG2TS container, VIDEO, (Since 3.0)
MEDIA_FORMAT_CONTAINER_MPEG2PS	media format mime type is MPEG2PS container, VIDEO, (Since 3.0)
MEDIA_FORMAT_CONTAINER_MATROSKA	media format mime type is MATROSKA container, VIDEO, (Since 3.0)
MEDIA_FORMAT_CONTAINER_WEBM	media format mime type is WEBM container, VIDEO, (Since 3.0)
MEDIA_FORMAT_CONTAINER_3GP	media format mime type is 3GP container, VIDEO, (Since 3.0)
MEDIA_FORMAT_CONTAINER_WAV	media format mime type is WAV container, AUDIO, (Since 3.0)
MEDIA_FORMAT_CONTAINER_OGG	media format mime type is OGG container, AUDIO, (Since 3.0)
MEDIA_FORMAT_CONTAINER_AAC_ADTS	media format mime type is AAC_ADTS container, AUDIO, (Since 3.0)
MEDIA_FORMAT_CONTAINER_AAC_ADIF	media format mime type is AAC_ADIF container, AUDIO, (Since 3.0)
MEDIA_FORMAT_NATIVE_VIDEO	media format mime type is HW dependent, VIDEO, (Since 3.0)
MEDIA_FORMAT_TEXT_MP4	media format mime type is MP4, TEXT, (Since 3.0)
MEDIA_FORMAT_TEXT_3GP	media format mime type is 3GP, TEXT, (Since 3.0)
MEDIA_FORMAT_MAX	media format mime type is MEDIA_FORMAT_MAX, Do not use

enum media_format_text_type_e

Enumeration for media format text type.

Since :: 3.0

Enumerator:

MEDIA_FORMAT_TEXT_TYPE_NONE	media format text type is none
MEDIA_FORMAT_TEXT_TYPE_TIMED_TEXT_MP4	media format text type is MPEG-4 Timed Text
MEDIA_FORMAT_TEXT_TYPE_TIMED_TEXT_3GPP	media format text type is 3GPP Timed Text
MEDIA_FORMAT_TEXT_TYPE_UNKNOWN	media format text type is unknown

enum media_format_type_e

Enumeration for media format type.

Since :: 2.3.1

Enumerator:

MEDIA_FORMAT_NONE	media format type is NONE
MEDIA_FORMAT_AUDIO	media format type is AUDIO
MEDIA_FORMAT_VIDEO	media format type is VIDEO
MEDIA_FORMAT_TEXT	media format type is TEXT
MEDIA_FORMAT_CONTAINER	media format type is CONTAINER
MEDIA_FORMAT_UNKNOWN	media format type is UNKNOWN

Function Documentation

int media_format_channel_positions_from_mask	(	media_format_h	fmt,
		uint64_t	channel_mask,
		media_format_channel_position_e **	positions
	)

Converts the channels in the channel_mask to a positions array.

The size of the position array is equal to the number of channels, that can be obtained with media_format_get_audio_info().

Since :: 5.5

Remarks:: A channel_mask with fewer bits set than the number of channels is considered valid. The positions should be released with free().

Parameters:

[in]	fmt	The media format handle
[in]	channel_mask	The input channel_mask
[out]	positions	The channel positions array, its length is equal to the number of channels

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

Precondition:: The number of channels must be set with media_format_set_audio_channel().; The channel should be set before calling media_format_channel_positions_from_mask().

See also:: media_format_set_audio_channel(); media_format_get_audio_info()

Example

   int channels;
   uint64_t channel_mask;
   media_format_channel_position_e *positions;

   media_format_get_audio_info(fmt, NULL, &channels, NULL, NULL, NULL);
   positions = malloc(channels * sizeof(media_format_channel_position_e));
   media_format_channel_positions_from_mask(fmt, channel_mask, &positions);
   ...
   free(positions);

int media_format_channel_positions_to_mask	(	media_format_h	fmt,
		const media_format_channel_position_e *	positions,
		uint64_t *	channel_mask_out
	)

Converts the positions array to a bitmask.

Since :: 5.5

Remarks:: A channel_mask_out with fewer bits set than the number of channels is considered valid.

Parameters:

[in]	fmt	The media format handle
[in]	positions	The channel positions array, its lengh is equal to the number of channels
[out]	channel_mask_out	the output channel mask

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

Precondition:: The number of channels must be set with media_format_set_audio_channel().; The channel should be set before calling media_format_channel_positions_to_mask().

See also:: media_format_set_audio_channel()

int media_format_create ( media_format_h * fmt )

Creates a media format.

Since :: 2.3.1

It creates media format. and reference count will be set to 1 For destroying media_format_h handle, use media_format_unref().

Parameters:

[out] fmt allocated media_format_h

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_ref(); media_format_unref()

int media_format_get_audio_aac_header_type	(	media_format_h	fmt,
		media_format_aac_header_type_e *	aac_header_type
	)

Gets audio aac header type of media format.

Since :: 3.0

Parameters:

[in]	fmt	The media_format_h to get audio information
[out]	aac_header_type	The media_format_aac_header_type_e, ex) MEDIA_FORMAT_AAC_HEADER_ADTS

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_set_audio_aac_header_type()

int media_format_get_audio_aac_type	(	media_format_h	fmt,
		bool *	is_adts
	)

Gets audio aac type of media format.

Since :: 3.0

Parameters:

[in]	fmt	media_format_h to get audio information
[out]	is_adts	AAC ADTS flag of the audio

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_set_audio_aac_type()

int media_format_get_audio_bit_depth	(	media_format_h	fmt,
		int *	bit_depth
	)

Gets the number of bits of information in digital audio using pulse-code modulation (PCM).

Since :: 5.5

Parameters:

[in]	fmt	The media format handle
[out]	bit_depth	The number of bits of information in each sample

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_set_audio_aac_header_type()

int media_format_get_audio_channel_mask	(	media_format_h	fmt,
		uint64_t *	channel_mask
	)

Gets audio channel mask of media format.

Since :: 5.5

Parameters:

[in]	fmt	The media format handle
[out]	channel_mask	The output channel mask

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_PACKET_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_set_audio_channel_mask(); media_format_channel_positions_from_mask()

Example

   int channels;
   uint64_t channel_mask;
   media_format_channel_position_e *positions;

   media_format_get_audio_info(fmt, NULL, &channels, NULL, NULL, NULL);
   positions = malloc(channels * sizeof(media_format_channel_position_e));
   media_format_get_audio_channel_mask(fmt, &channel_mask);
   media_format_channel_positions_from_mask(fmt, channel_mask, &positions);
   ...
   free(positions);

int media_format_get_audio_info	(	media_format_h	fmt,
		media_format_mimetype_e *	mimetype,
		int *	channel,
		int *	samplerate,
		int *	bit,
		int *	avg_bps
	)

Gets audio information of media format.

Since :: 2.3.1

returns mimetype, channels, height, samplerate bps, max bps of this media format.

Parameters:

[in]	fmt	media_format_h to get audio information
[out]	mimetype	media_format_mimetype_e , ex) MEDIA_FORMAT_PCM
[out]	channel	channel of the audio
[out]	samplerate	sampling rate of the audio
[out]	bit	bit resolution of the audio
[out]	avg_bps	average bps of the audio

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_set_audio_mime(); media_format_set_audio_channel(); media_format_set_audio_samplerate(); media_format_set_audio_bit(); media_format_set_audio_avg_bps()

int media_format_get_container_mime	(	media_format_h	fmt,
		media_format_mimetype_e *	mimetype
	)

Gets container MIME type of media format.

Since :: 3.0

Parameters:

[in]	fmt	The media_format_h to get container mime type
[out]	mimetype	The media_format_mimetype_e, ex) MEDIA_FORMAT_CONTAINER_MP4

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_set_container_mime()

int media_format_get_extra	(	media_format_h	fmt,
		void **	extra_data
	)

Gets extra data of media format.

The user can get extra data which user sets value via media_format_set_extra().

Since :: 4.0

Remarks:: The application is responsible for freeing extra_data. For description of extra data behavior upon making an object writable, see the description of media_format_make_writable().

Parameters:

[in]	fmt	The media format handle
[out]	extra_data	The extra data to get

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: media_format_set_extra()

int media_format_get_text_info	(	media_format_h	fmt,
		media_format_mimetype_e *	mimetype,
		media_format_text_type_e *	type
	)

Gets text track information of media format.

Since :: 3.0

Parameters:

[in]	fmt	The media_format_h to get text information
[out]	mimetype	The media_format_mimetype_e, ex) MEDIA_FORMAT_TEXT_MP4
[out]	type	The media_format_text_type_e

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_set_text_mime()

int media_format_get_type	(	media_format_h	fmt,
		media_format_type_e *	formattype
	)

Gets format type of media format.

Since :: 3.0

Parameters:

[in]	fmt	The media_format_h to get format type
[out]	formattype	The media_format_type_e, ex) MEDIA_FORMAT_AUDIO

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

int media_format_get_video_frame_rate	(	media_format_h	fmt,
		int *	frame_rate
	)

Gets video frame rate of media format.

Since :: 3.0

Parameters:

[in]	fmt	The media_format_h to get
[out]	frame_rate	The video frame rate

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

int media_format_get_video_info	(	media_format_h	fmt,
		media_format_mimetype_e *	mimetype,
		int *	width,
		int *	height,
		int *	avg_bps,
		int *	max_bps
	)

Gets video information of media format.

Since :: 2.3.1

returns mimetype, width, height, average bps, max bps of this media format.

Parameters:

[in]	fmt	media_format_h to get video information
[out]	mimetype	media_format_mimetype_e , ex) MEDIA_FORMAT_H264_HP
[out]	width	width of the video
[out]	height	height of the video
[out]	avg_bps	average bps of the video
[out]	max_bps	max bps of the video

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_set_video_mime(); media_format_set_video_width(); media_format_set_video_height(); media_format_set_video_avg_bps(); media_format_set_video_max_bps()

int media_format_is_little_endian	(	media_format_h	fmt,
		bool *	is_little_endian
	)

Checks whether the given media format is little endian.

Since :: 5.5

Parameters:

[in]	fmt	The media format handle
[out]	is_little_endian	`true` if the given media format is little endian, `false` if the given media format is big endian

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_PACKET_ERROR_NONE	Successful
MEDIA_PACKET_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_PACKET_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_mimetype_e; media_format_type_e

int media_format_is_writable	(	media_format_h	fmt,
		bool *	is_writable
	)

Checks whether the media_format_h is writable or not.

Since :: 2.3.1

Parameters:

[in]	fmt	exist media_format_h
[out]	is_writable	if ref_count is 1, return true. if not, return false

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_make_writable()

int media_format_make_writable	(	media_format_h	fmt,
		media_format_h *	out_fmt
	)

Returns a writable copy of media_format_h.

If there is only one reference count on fmt, the caller must be the owner, and so this function will return the object unchanged. while, if there is more than one reference count on the object, a new object will be returned. The caller will own a reference to the returned object. In a nutshell, this function unrefs the fmt and refs the out_fmt returned. Don't access fmt after calling this function.

Since :: 2.3.1

Remarks:: If a new object is returned, it will not have its own copy of extra data. The new object's extra data object will be the original object's extra data.

Parameters:

[in]	fmt	exist media_format_h , don't access it after calling this function
[out]	out_fmt	new copied media_format_h, the caller is owner of this object

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_is_writable()

int media_format_ref ( media_format_h fmt )

Increases reference count of media_format_h object.

Since :: 2.3.1

increase ref_count of media_format_h

Parameters:

[in] fmt exist media_format_h

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_unref()

int media_format_set_audio_aac_header_type	(	media_format_h	fmt,
		media_format_aac_header_type_e	aac_header_type
	)

Sets audio aac header type of media format.

Since :: 3.0

Parameters:

[in]	fmt	The media_format_h to get audio information
[in]	aac_header_type	The media_format_aac_header_type_e, ex) MEDIA_FORMAT_AAC_HEADER_ADTS

Precondition:: must set audio MIME type by media_format_set_audio_mime()

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_audio_aac_header_type()

int media_format_set_audio_aac_type	(	media_format_h	fmt,
		bool	is_adts
	)

Sets audio aac type of media format.

Since :: 3.0

Sets audio aac data type of this media format

Parameters:

[in]	fmt	media_format_h to set
[in]	is_adts	aac adts flag of the audio

Precondition:: must set audio MIME type by media_format_set_audio_mime()

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_audio_aac_type()

int media_format_set_audio_avg_bps	(	media_format_h	fmt,
		int	avg_bps
	)

Sets audio avg_bps of media format.

Since :: 2.3.1

Parameters:

[in]	fmt	media_format_h to set
[in]	avg_bps	average bit per second of the audio

Precondition:: must set audio MIME type by media_format_set_audio_mime()

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_audio_info()

int media_format_set_audio_bit	(	media_format_h	fmt,
		int	bit
	)

Sets audio bit of media format.

Since :: 2.3.1

Sets audio bit resolution of this media format

Parameters:

[in]	fmt	media_format_h to set
[in]	bit	bit of the audio

Precondition:: must set audio MIME type by media_format_set_audio_mime()

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_audio_info()

int media_format_set_audio_channel	(	media_format_h	fmt,
		int	channel
	)

Sets audio channel of media format.

Since :: 2.3.1

Parameters:

[in]	fmt	media_format_h to set audio information
[in]	channel	channel of the audio

Precondition:: must set audio MIME type by media_format_set_audio_mime()

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_audio_info()

int media_format_set_audio_channel_mask	(	media_format_h	fmt,
		uint64_t	channel_mask
	)

Sets audio channel mask of media format.

Since :: 5.5

Parameters:

[in]	fmt	The media format handle
[in]	channel_mask	The input channel mask

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_PACKET_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_audio_channel_mask(); media_format_channel_positions_to_mask()

Example

   uint64_t channel_mask;
   media_format_channel_position_e position[2];

   position[0] = MEDIA_FORMAT_CHANNEL_POSITION_FRONT_LEFT;
   position[1] = MEDIA_FORMAT_CHANNEL_POSITION_FRONT_RIGHT;

   media_format_channel_positions_to_mask(fmt, position, &channel_mask);
   media_format_set_audio_channel_mask(fmt, channel_mask);

int media_format_set_audio_mime	(	media_format_h	fmt,
		media_format_mimetype_e	mimetype
	)

Sets audio MIME type of media format.

Since :: 2.3.1

Parameters:

[in]	fmt	media_format_h to set audio information
[in]	mimetype	media_format_mimetype_e , ex) MEDIA_FORMAT_PCM

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_audio_info()

int media_format_set_audio_samplerate	(	media_format_h	fmt,
		int	samplerate
	)

Sets audio samplerate of media format.

Since :: 2.3.1

Parameters:

[in]	fmt	media_format_h to set
[in]	samplerate	sampling rate of the audio

Precondition:: must set audio MIME type by media_format_set_audio_mime()

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_audio_info()

int media_format_set_container_mime	(	media_format_h	fmt,
		media_format_mimetype_e	mimetype
	)

Sets container MIME type of media format.

Since :: 3.0

Parameters:

[in]	fmt	The media_format_h to set
[in]	mimetype	The media_format_mimetype_e, ex) MEDIA_FORMAT_CONTAINER_MP4

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_container_mime()

int media_format_set_extra	(	media_format_h	fmt,
		void *	extra_data
	)

Sets extra data of media format.

The user can set data that media format does not support.

Since :: 4.0

Remarks:: The application is responsible for freeing extra_data. For description of extra data behavior upon making an object writable, see the description of media_format_make_writable().

Parameters:

[in]	fmt	The media format handle
[in]	extra_data	The extra data to set

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: media_format_get_extra()

int media_format_set_text_mime	(	media_format_h	fmt,
		media_format_mimetype_e	mimetype
	)

Sets text MIME type of media format.

Since :: 3.0

Parameters:

[in]	fmt	The media_format_h to set
[in]	mimetype	The media_format_mimetype_e, ex) MEDIA_FORMAT_TEXT

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_text_info()

int media_format_set_text_type	(	media_format_h	fmt,
		media_format_text_type_e	type
	)

Sets text type of media format.

Since :: 3.0

Parameters:

[in]	fmt	The media_format_h to set
[in]	type	The text type

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_text_info()

int media_format_set_video_avg_bps	(	media_format_h	fmt,
		int	avg_bps
	)

Sets video avg_bps of media format.

Since :: 2.3.1

Parameters:

[in]	fmt	media_format_h to set
[in]	avg_bps	average bps of the video

Precondition:: must set video MIME type by media_format_set_video_mime()

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_video_info()

int media_format_set_video_frame_rate	(	media_format_h	fmt,
		int	frame_rate
	)

Sets video frame rate of media format.

Since :: 3.0

Parameters:

[in]	fmt	The media_format_h to set
[in]	frame_rate	The video frame rate

Precondition:: must set video MIME type by media_format_set_video_mime()

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

int media_format_set_video_height	(	media_format_h	fmt,
		int	height
	)

Sets video height of media format.

Since :: 2.3.1

Parameters:

[in]	fmt	media_format_h to set
[in]	height	height of the video

Precondition:: must set video MIME type by media_format_set_video_mime()

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_video_info()

int media_format_set_video_max_bps	(	media_format_h	fmt,
		int	max_bps
	)

Sets video max_bps of media format.

Since :: 2.3.1

Parameters:

[in]	fmt	media_format_h to set
[in]	max_bps	max bps of the video

Precondition:: must set video MIME type by media_format_set_video_mime()

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_video_info()

int media_format_set_video_mime	(	media_format_h	fmt,
		media_format_mimetype_e	mimetype
	)

Sets video MIME type of media format.

Since :: 2.3.1

Parameters:

[in]	fmt	media_format_h to set
[in]	mimetype	media_format_mimetype_e , ex) MEDIA_FORMAT_H264_HP

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_video_info()

int media_format_set_video_width	(	media_format_h	fmt,
		int	width
	)

Sets video width of media format.

Since :: 2.3.1

Parameters:

[in]	fmt	media_format_h to set
[in]	width	width of the video

Precondition:: must set video MIME type by media_format_set_video_mime()

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_get_video_info()

int media_format_unref ( media_format_h fmt )

Decreases reference count of media_format_h object.

Since :: 2.3.1

Parameters:

[in] fmt exist media_format_h

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIA_FORMAT_ERROR_NONE	Successful
MEDIA_FORMAT_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_FORMAT_ERROR_OUT_OF_MEMORY	Out of memory
MEDIA_FORMAT_ERROR_INVALID_OPERATION	Invalid operation

See also:: media_format_ref()

Required Header

Functions

Typedefs

Typedef Documentation

Enumeration Type Documentation

Function Documentation