Remove profile tag
[platform/core/api/media-content.git] / include_product / media_group.h
index 0e82105..e9819ad 100755 (executable)
@@ -41,7 +41,7 @@ extern "C" {
 
 /**
  * @brief Gets the number of the album for the passed @a filter from the media database.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] filter The handle to the media filter
  * @param[out] album_count The count of the media album
@@ -53,7 +53,6 @@ extern "C" {
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  *
  * @pre This function requires opened connection to content service by media_content_connect().
  *
@@ -67,7 +66,7 @@ int media_album_get_album_count_from_db(filter_h filter, int *album_count);
  *          The callback function will be invoked for every retrieved media album.
  *          If @c NULL is passed to the filter, no filtering is applied.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] filter The handle to the media filter
  * @param[in] callback The callback function to be invoked
@@ -81,7 +80,6 @@ int media_album_get_album_count_from_db(filter_h filter, int *album_count);
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  *
  * @pre  This function requires opened connection to content service by media_content_connect().
  * @post This function invokes media_album_cb().
@@ -94,7 +92,7 @@ int media_album_foreach_album_from_db(filter_h filter, media_album_cb callback,
 
 /**
  * @brief Gets the number of media info for the given album present in the media database.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] album_id The ID of the media album
  * @param[in] filter The handle to the media filter
@@ -107,7 +105,6 @@ int media_album_foreach_album_from_db(filter_h filter, media_album_cb callback,
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  *
  * @pre This function requires opened connection to content service by media_content_connect().
  *
@@ -121,7 +118,7 @@ int media_album_get_media_count_from_db(int album_id, filter_h filter, int *medi
  *          meeting desired filter option and calls @a callback for
  *          every retrieved media info. If @c NULL is passed to the @a filter, no filtering is applied.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] album_id The ID of the media album
  * @param[in] filter The handle to the media filter
@@ -136,7 +133,6 @@ int media_album_get_media_count_from_db(int album_id, filter_h filter, int *medi
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  *
  * @pre  This function requires opened connection to content service by media_content_connect().
  * @post This function invokes media_info_cb().
@@ -150,10 +146,10 @@ int media_album_foreach_media_from_db(int album_id, filter_h filter, media_info_
 /**
  * @brief Destroys the album handle.
  * @details This function frees all resources related to the album handle. This handle
- *          can no longer be used to perform any operation. A new handle has to
+ *          can no longer be used to perform any operations. A new handle has to
  *          be created before the next use.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] album The handle to the media album
  *
@@ -176,7 +172,7 @@ int media_album_destroy(media_album_h album);
  *          media album foreach function such as media_album_foreach_album_from_db(). To use this handle outside of these foreach functions,
  *          use this function.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a dst should be released using media_album_destroy().
  *
@@ -197,7 +193,7 @@ int media_album_clone(media_album_h *dst, media_album_h src);
 
 /**
  * @brief Gets the ID of the album.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] album The handle to the media album
  * @param[out] album_id The ID of the media album
@@ -214,7 +210,7 @@ int media_album_get_album_id(media_album_h album, int *album_id);
 
 /**
  * @brief Gets the name of the album.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a album_name should be released using free().
  *
@@ -232,7 +228,7 @@ int media_album_get_name(media_album_h album, char **album_name);
 
 /**
  * @brief Gets the name of the artist from the given album.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a artist should be released using free().
  *
@@ -250,7 +246,7 @@ int media_album_get_artist(media_album_h album, char **artist);
 
 /**
  * @brief Gets the album art path from the album.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a album_art should be released using free().
  *
@@ -272,7 +268,7 @@ int media_album_get_album_art(media_album_h album, char **album_art);
  * @details This function creates a new media album handle from the media database by the given @a album_id.
  *          Media album will be created and will be filled with the album information.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a album should be released using media_album_destroy().
  *
@@ -287,7 +283,6 @@ int media_album_get_album_art(media_album_h album, char **album_art);
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  *
  * @pre This function requires opened connection to content service by media_content_connect().
  *
@@ -309,7 +304,7 @@ int media_album_get_album_from_db(int album_id, media_album_h *album);
 
  /**
  * @brief Gets the number of the group for the passed @a filter from the media database.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] filter The handle to the media filter
  * @param[in] group The type of the media group
@@ -322,7 +317,6 @@ int media_album_get_album_from_db(int album_id, media_album_h *album);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  *
  * @pre This function requires opened connection to content service by media_content_connect().
  *
@@ -336,7 +330,7 @@ int media_group_get_group_count_from_db(filter_h filter, media_group_e group, in
  *          The callback function will be invoked for every retrieved media group.
  *          If @c NULL is passed to the filter, no filtering is applied.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] filter The handle to the media filter
  * @param[in] group The type of the media group
@@ -351,7 +345,6 @@ int media_group_get_group_count_from_db(filter_h filter, media_group_e group, in
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  *
  * @pre  This function requires opened connection to content service by media_content_connect().
  * @post This function invokes media_group_cb().
@@ -364,7 +357,7 @@ int media_group_foreach_group_from_db(filter_h filter, media_group_e group, medi
 
  /**
  * @brief Gets the count of the media info for the given media group present in the media database.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] group_name The name of the media group
  * @param[in] group The type of the media group
@@ -379,7 +372,6 @@ int media_group_foreach_group_from_db(filter_h filter, media_group_e group, medi
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  *
  * @pre This function requires opened connection to content service by media_content_connect().
  *
@@ -393,7 +385,7 @@ int media_group_get_media_count_from_db(const char *group_name, media_group_e gr
  *          meeting desired filter option and calls @a callback for
  *          every retrieved media info. If @c NULL is passed to the @a filter, no filtering is applied.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] group_name The name of the media group
  * @param[in] group The type of the media group
@@ -409,7 +401,6 @@ int media_group_get_media_count_from_db(const char *group_name, media_group_e gr
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_DB_FAILED         DB Operation failed
  * @retval #MEDIA_CONTENT_ERROR_DB_BUSY           DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  *
  * @pre  This function requires opened connection to content service by media_content_connect().
  * @post This function invokes media_info_cb().