[ACR-1838] Deprecate all bookmark and playlist funtions

[platform/core/api/media-content.git] / include / media_bookmark.h

diff --git a/include/media_bookmark.h b/include/media_bookmark.h
index 5991c5b..8872b7b 100755 (executable)
--- a/include/media_bookmark.h
+++ b/include/media_bookmark.h
@@ -38,6 +38,7 @@ extern "C" {
  */
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Inserts a new bookmark in media on the specified time offset to the media database.
  * @since_tizen 2.3
  *
@@ -65,9 +66,10 @@ extern "C" {
  * @see media_content_connect()
  * @see media_bookmark_delete_from_db()
  */
-int media_bookmark_insert_to_db(const char *media_id, time_t time, const char *thumbnail_path);
+int media_bookmark_insert_to_db(const char *media_id, time_t time, const char *thumbnail_path) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Removes a media bookmark from the media database.
  * @since_tizen 2.3
  *
@@ -92,9 +94,10 @@ int media_bookmark_insert_to_db(const char *media_id, time_t time, const char *t
  * @see media_content_connect()
  * @see media_bookmark_insert_to_db()
  */
-int media_bookmark_delete_from_db(int bookmark_id);
+int media_bookmark_delete_from_db(int bookmark_id) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the number of bookmarks with an optional filter from the media database.
  * @since_tizen 2.3
  *
@@ -113,9 +116,10 @@ int media_bookmark_delete_from_db(int bookmark_id);
  *
  * @see media_content_connect()
  */
-int media_bookmark_get_bookmark_count_from_db(filter_h filter, int *bookmark_count);
+int media_bookmark_get_bookmark_count_from_db(filter_h filter, int *bookmark_count) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Iterates through the bookmarks with an optional filter from the media database.
  * @details This function gets all bookmarks associated with the given filter and calls @a callback for every retrieved media bookmark.
  *          If @c NULL is passed to the @a filter, then no filtering is applied.
@@ -141,9 +145,10 @@ int media_bookmark_get_bookmark_count_from_db(filter_h filter, int *bookmark_cou
  * @see media_bookmark_cb()
  * @see media_filter_create()
  */
-int media_bookmark_foreach_bookmark_from_db(filter_h filter, media_bookmark_cb callback, void *user_data);
+int media_bookmark_foreach_bookmark_from_db(filter_h filter, media_bookmark_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Clones a media bookmark.
  * @details This function copies the media bookmark handle from a source to destination. There is no media_bookmark_create() function.
  *          The media_bookmark_h is created internally and available through media bookmark foreach function such as media_info_foreach_bookmark_from_db().
@@ -166,9 +171,10 @@ int media_bookmark_foreach_bookmark_from_db(filter_h filter, media_bookmark_cb c
  * @see media_bookmark_destroy()
  * @see media_info_foreach_bookmark_from_db()
  */
-int media_bookmark_clone(media_bookmark_h *dst, media_bookmark_h src);
+int media_bookmark_clone(media_bookmark_h *dst, media_bookmark_h src) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Destroys a media bookmark.
  * @details This function frees all the resources related to the bookmark handle. This handle
  *          no longer can be used to perform any operations. A new handle has to
@@ -188,9 +194,10 @@ int media_bookmark_clone(media_bookmark_h *dst, media_bookmark_h src);
  *
  * @see media_bookmark_clone()
  */
-int media_bookmark_destroy(media_bookmark_h bookmark);
+int media_bookmark_destroy(media_bookmark_h bookmark) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the bookmark ID.
  * @since_tizen 2.3
  *
@@ -203,9 +210,10 @@ int media_bookmark_destroy(media_bookmark_h bookmark);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_bookmark_get_bookmark_id(media_bookmark_h bookmark, int *bookmark_id);
+int media_bookmark_get_bookmark_id(media_bookmark_h bookmark, int *bookmark_id) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the bookmark time marked parameter.
  * @details This function returns time offset in seconds from beginning of the movie on which bookmark
  *          was placed.
@@ -221,9 +229,10 @@ int media_bookmark_get_bookmark_id(media_bookmark_h bookmark, int *bookmark_id);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_bookmark_get_marked_time(media_bookmark_h bookmark, time_t *marked_time);
+int media_bookmark_get_marked_time(media_bookmark_h bookmark, time_t *marked_time) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the media bookmark thumbnail.
  * @since_tizen 2.3
  *
@@ -239,9 +248,10 @@ int media_bookmark_get_marked_time(media_bookmark_h bookmark, time_t *marked_tim
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int media_bookmark_get_thumbnail_path(media_bookmark_h bookmark, char **path);
+int media_bookmark_get_thumbnail_path(media_bookmark_h bookmark, char **path) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the media bookmark name which user set.
  * @since_tizen 4.0
  *
@@ -258,9 +268,10 @@ int media_bookmark_get_thumbnail_path(media_bookmark_h bookmark, char **path);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int media_bookmark_get_name(media_bookmark_h bookmark, char **name);
+int media_bookmark_get_name(media_bookmark_h bookmark, char **name) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Sets the media bookmark name.
  * @since_tizen 4.0
  *
@@ -276,9 +287,10 @@ int media_bookmark_get_name(media_bookmark_h bookmark, char **name);
  *
  * @post media_bookmark_update_to_db()
  */
-int media_bookmark_set_name(media_bookmark_h bookmark, const char *name);
+int media_bookmark_set_name(media_bookmark_h bookmark, const char *name) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Updates bookmark information to the media database.
  * @details The function updates the given bookmark meta in the media database. \n
  *          The function should be called after any change in bookmark attributes, to be updated to the media database. \n
@@ -309,7 +321,7 @@ int media_bookmark_set_name(media_bookmark_h bookmark, const char *name);
  * @see media_content_connect()
  * @see media_bookmark_set_name()
  */
-int media_bookmark_update_to_db(media_bookmark_h bookmark);
+int media_bookmark_update_to_db(media_bookmark_h bookmark) TIZEN_DEPRECATED_API;
 
 /**
  * @}