[ACR-1819] Deprecate meaningless media group enum

[platform/core/api/media-content.git] / include_product / media_tag.h

diff --git a/include_product/media_tag.h b/include_product/media_tag.h
index 91d110e..f489062 100755 (executable)
--- a/include_product/media_tag.h
+++ b/include_product/media_tag.h
@@ -40,6 +40,7 @@ extern "C" {
  */
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Inserts a new tag in the media database.
  * @since_tizen 2.3
  *
@@ -69,9 +70,10 @@ extern "C" {
  * @see media_tag_delete_from_db()
  * @see media_tag_destroy()
  */
-int media_tag_insert_to_db(const char *tag_name, media_tag_h *tag);
+int media_tag_insert_to_db(const char *tag_name, media_tag_h *tag) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Deletes a given tag from the media database.
  * @since_tizen 2.3
  *
@@ -96,9 +98,10 @@ int media_tag_insert_to_db(const char *tag_name, media_tag_h *tag);
  * @see media_content_connect()
  * @see media_tag_insert_to_db()
  */
-int media_tag_delete_from_db(int tag_id);
+int media_tag_delete_from_db(int tag_id) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the count of the tag for the passed @a filter from the media database.
  * @since_tizen 2.3
  *
@@ -117,9 +120,10 @@ int media_tag_delete_from_db(int tag_id);
  *
  * @see media_content_connect()
  */
-int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count);
+int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Iterates through tags from the media database.
  * @details This function gets all tags meeting a desired @a filter
  *          and calls a registered callback function for every retrieved tag.
@@ -147,9 +151,10 @@ int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count);
  * @see #media_tag_cb
  * @see media_filter_create()
  */
-int media_tag_foreach_tag_from_db(filter_h filter, media_tag_cb callback, void *user_data);
+int media_tag_foreach_tag_from_db(filter_h filter, media_tag_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the number of media files for the passed @a filter in the given @a tag_id from the media database.
  * @since_tizen 2.3
  *
@@ -169,9 +174,10 @@ int media_tag_foreach_tag_from_db(filter_h filter, media_tag_cb callback, void *
  *
  * @see media_content_connect()
  */
-int media_tag_get_media_count_from_db(int tag_id, filter_h filter, int *media_count);
+int media_tag_get_media_count_from_db(int tag_id, filter_h filter, int *media_count) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Iterates through media items for a given tag from the media database.
  * @details This function gets all media items associated with a given tag and
  *          meeting a desired @a filter and calls a registered callback function for
@@ -200,9 +206,10 @@ int media_tag_get_media_count_from_db(int tag_id, filter_h filter, int *media_co
  * @see media_info_cb()
  * @see media_filter_create()
  */
-int media_tag_foreach_media_from_db(int tag_id, filter_h filter, media_info_cb callback, void *user_data);
+int media_tag_foreach_media_from_db(int tag_id, filter_h filter, media_info_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Clones the media tag.
  * @details This function copies the media tag handle from a source to destination.
  *          There is no media_tag_create() function. The #media_tag_h is created internally and available through media tag foreach function
@@ -225,9 +232,10 @@ int media_tag_foreach_media_from_db(int tag_id, filter_h filter, media_info_cb c
  *
  * @see media_tag_destroy()
  */
-int media_tag_clone(media_tag_h *dst, media_tag_h src);
+int media_tag_clone(media_tag_h *dst, media_tag_h src) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Destroys the media tag.
  * @details This function frees all resources related to the tag handle. The tag handle can no longer
  *          be used for any operations. A new tag handle has to be created before next usage.
@@ -247,9 +255,10 @@ int media_tag_clone(media_tag_h *dst, media_tag_h src);
  * @see media_tag_clone()
  * @see media_tag_insert_to_db()
  */
-int media_tag_destroy(media_tag_h tag);
+int media_tag_destroy(media_tag_h tag) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the media tag ID.
  * @since_tizen 2.3
  *
@@ -262,9 +271,10 @@ int media_tag_destroy(media_tag_h tag);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_tag_get_tag_id(media_tag_h tag, int *tag_id);
+int media_tag_get_tag_id(media_tag_h tag, int *tag_id) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the tag name.
  * @since_tizen 2.3
  *
@@ -280,9 +290,10 @@ int media_tag_get_tag_id(media_tag_h tag, int *tag_id);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int media_tag_get_name(media_tag_h tag, char **tag_name);
+int media_tag_get_name(media_tag_h tag, char **tag_name) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the media tag from the media database.
  *
  * @details This function creates a new media tag handle from the media database by the given @a tag_id.
@@ -309,9 +320,10 @@ int media_tag_get_name(media_tag_h tag, char **tag_name);
  * @see media_content_connect()
  * @see media_tag_destroy()
  */
-int media_tag_get_tag_from_db(int tag_id, media_tag_h *tag);
+int media_tag_get_tag_from_db(int tag_id, media_tag_h *tag) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Adds a new media info to the tag.
  * @since_tizen 2.3
  *
@@ -331,9 +343,10 @@ int media_tag_get_tag_from_db(int tag_id, media_tag_h *tag);
  * @see media_content_connect()
  * @see media_tag_remove_media()
  */
-int media_tag_add_media(media_tag_h tag, const char *media_id);
+int media_tag_add_media(media_tag_h tag, const char *media_id) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Removes the media info from the given tag.
  * @since_tizen 2.3
  *
@@ -353,9 +366,10 @@ int media_tag_add_media(media_tag_h tag, const char *media_id);
  * @see media_content_connect()
  * @see media_tag_add_media()
  */
-int media_tag_remove_media(media_tag_h tag, const char *media_id);
+int media_tag_remove_media(media_tag_h tag, const char *media_id) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Sets the name of the tag.
  * @since_tizen 2.3
  *
@@ -371,9 +385,10 @@ int media_tag_remove_media(media_tag_h tag, const char *media_id);
  *
  * @post media_tag_update_to_db()
  */
-int media_tag_set_name(media_tag_h tag, const char *tag_name);
+int media_tag_set_name(media_tag_h tag, const char *tag_name) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Updates the media tag to the media database.
  *
  * @details The function updates the given media tag in the media database. The function should be called after any change in tag attributes, to be updated to the media
@@ -407,7 +422,7 @@ int media_tag_set_name(media_tag_h tag, const char *tag_name);
  * @see media_tag_remove_media()
  * @see media_tag_set_name()
  */
-int media_tag_update_to_db(media_tag_h tag);
+int media_tag_update_to_db(media_tag_h tag) TIZEN_DEPRECATED_API;
 
 /**
  * @}