Media Controller Playback ability

---

The Media Controller Playback ability API provides functions for the playback ability for the media controller server.

Required Header

#include <media_controller_metadata.h>

Overview

The Media Controller Playback ability API allows you to get playback action ability (mc_playback_action_is_supported()).
You can copy the ability by using mc_playback_ability_clone(). And if you don't use handle anymore, you have to destroy it(mc_playback_ability_destroy()).

Functions
int	mc_playback_ability_clone (mc_playback_ability_h src, mc_playback_ability_h *dst)
	Clones a playback ability handle.
int	mc_playback_ability_destroy (mc_playback_ability_h ability)
	Destroys a playback ability handle.
int	mc_playback_action_is_supported (mc_playback_ability_h ability, mc_playback_action_e action, mc_ability_support_e *supported)
	Gets the support value of the playback ability.

---

Function Documentation

int mc_playback_ability_clone	(	mc_playback_ability_h	src,
		mc_playback_ability_h *	dst
	)

Clones a playback ability handle.

This function copies the playback ability handle from a source to destination. The mc_playback_ability_h is created internally and available through playback ability functions.

Since :

5.0

Remarks:

The dst should be released using mc_playback_ability_destroy().

Parameters:

[in]	src	The source handle to the playback ability
[out]	dst	The destination handle to the playback ability

Returns:

0 on success, otherwise a negative error value

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORY	Out of memory

See also:

mc_playback_ability_destroy()

int mc_playback_ability_destroy

(

mc_playback_ability_h

ability

)

Destroys a playback ability handle.

This function frees all resources related to the playback ability handle. This handle no longer can be used to perform any operations. A new handle has to be created before next use.

Since :

5.0

Parameters:

[in]

ability

The handle to the playback ability

Returns:

0 on success, otherwise a negative error value

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter

See also:

mc_playback_ability_clone()

int mc_playback_action_is_supported	(	mc_playback_ability_h	ability,
		mc_playback_action_e	action,
		mc_ability_support_e *	supported
	)

Gets the support value of the playback ability.

Since :

5.0

Remarks:

If the ability's support is not set, the result value is MC_ABILITY_SUPPORTED_UNDECIDED.

Parameters:

[in]	ability	The handle to ability
[in]	action	The playback action to get
[out]	supported	The support value of the ability

Returns:

0 on success, otherwise a negative error value

Return values:

MEDIA_CONTROLLER_ERROR_NONE	Successful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORY	Out of memory

Precondition:

Call the mc_client_set_playback_ability_updated_cb() function to get the ability if you are the media controller client.

See also:

mc_client_set_playback_ability_updated_cb()

mc_client_get_server_playback_ability()