Tizen Native API  5.0
Functions
Media Controller Playback ability
Media Controller

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]srcThe source handle to the playback ability
[out]dstThe destination handle to the playback ability
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut 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]abilityThe handle to the playback ability
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid 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]abilityThe handle to ability
[in]actionThe playback action to get
[out]supportedThe support value of the ability
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIA_CONTROLLER_ERROR_NONESuccessful
MEDIA_CONTROLLER_ERROR_INVALID_PARAMETERInvalid parameter
MEDIA_CONTROLLER_ERROR_OUT_OF_MEMORYOut 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()