Tizen Native API
7.0
|
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 of the playback ability [out] dst The destination handle of 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 of 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 of the playback 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.