lib: deprecate media discoverer events
authorThomas Guillem <thomas@gllm.fr>
Fri, 10 Jun 2016 12:30:51 +0000 (14:30 +0200)
committerThomas Guillem <thomas@gllm.fr>
Fri, 10 Jun 2016 12:39:06 +0000 (14:39 +0200)
include/vlc/deprecated.h
include/vlc/libvlc_events.h
include/vlc/libvlc_media_discoverer.h

index 0a1277a..5a65043 100644 (file)
@@ -277,6 +277,18 @@ libvlc_media_discoverer_new_from_name( libvlc_instance_t * p_inst,
 LIBVLC_DEPRECATED LIBVLC_API char *
 libvlc_media_discoverer_localized_name( libvlc_media_discoverer_t * p_mdis );
 
+/**
+ * Get event manager from media service discover object.
+ *
+ * \deprecated Useless, media_discoverer events are only triggered when calling
+ * libvlc_media_discoverer_start() and libvlc_media_discoverer_stop().
+ *
+ * \param p_mdis media service discover object
+ * \return event manager object.
+ */
+LIBVLC_DEPRECATED LIBVLC_API libvlc_event_manager_t *
+libvlc_media_discoverer_event_manager( libvlc_media_discoverer_t * p_mdis );
+
 /** @}*/
 
 /**
index c5aecca..462fe7f 100644 (file)
@@ -100,7 +100,15 @@ enum libvlc_event_e {
     libvlc_MediaListPlayerNextItemSet,
     libvlc_MediaListPlayerStopped,
 
+    /**
+     * \deprecated Useless event, it will be triggered only when calling
+     * libvlc_media_discoverer_start()
+     */
     libvlc_MediaDiscovererStarted=0x500,
+    /**
+     * \deprecated Useless event, it will be triggered only when calling
+     * libvlc_media_discoverer_stop()
+     */
     libvlc_MediaDiscovererEnded,
 
     libvlc_VlmMediaAdded=0x600,
index 6dd86f1..79b8e43 100644 (file)
@@ -138,15 +138,6 @@ libvlc_media_discoverer_release( libvlc_media_discoverer_t * p_mdis );
 LIBVLC_API libvlc_media_list_t *
 libvlc_media_discoverer_media_list( libvlc_media_discoverer_t * p_mdis );
 
-/**
- * Get event manager from media service discover object.
- *
- * \param p_mdis media service discover object
- * \return event manager object.
- */
-LIBVLC_API libvlc_event_manager_t *
-libvlc_media_discoverer_event_manager( libvlc_media_discoverer_t * p_mdis );
-
 /**
  * Query if media service discover object is running.
  *