libvlc_media_discoverer
[libvlc]

Collaboration diagram for libvlc_media_discoverer:

LibVLC Media Discoverer. More...

Typedefs
typedef struct libvlc_media_discoverer_t	libvlc_media_discoverer_t
Functions
VLC_PUBLIC_API libvlc_media_discoverer_t *	libvlc_media_discoverer_new_from_name (libvlc_instance_t *p_inst, const char *psz_name, libvlc_exception_t *p_e)
	Discover media service by name.
VLC_PUBLIC_API void	libvlc_media_discoverer_release (libvlc_media_discoverer_t *p_mdis)
	Release media discover object.
VLC_PUBLIC_API char *	libvlc_media_discoverer_localized_name (libvlc_media_discoverer_t *p_mdis)
	Get media service discover object its localized name.
VLC_PUBLIC_API libvlc_media_list_t *	libvlc_media_discoverer_media_list (libvlc_media_discoverer_t *p_mdis)
	Get media service discover media list.
VLC_PUBLIC_API libvlc_event_manager_t *	libvlc_media_discoverer_event_manager (libvlc_media_discoverer_t *p_mdis)
	Get event manager from media service discover object.
VLC_PUBLIC_API int	libvlc_media_discoverer_is_running (libvlc_media_discoverer_t *p_mdis)
	Query if media service discover object is running.

---

Detailed Description

LibVLC Media Discoverer.

---

Typedef Documentation

typedef struct libvlc_media_discoverer_t libvlc_media_discoverer_t

---

Function Documentation

VLC_PUBLIC_API libvlc_event_manager_t* libvlc_media_discoverer_event_manager

(

libvlc_media_discoverer_t *

p_mdis

)

Get event manager from media service discover object.

Parameters:

p_mdis

media service discover object

Returns:

event manager object.

References libvlc_media_discoverer_t::p_event_manager.

VLC_PUBLIC_API int libvlc_media_discoverer_is_running

(

libvlc_media_discoverer_t *

p_mdis

)

Query if media service discover object is running.

Parameters:

p_mdis

media service discover object

Returns:

true if running, false if not

References libvlc_media_discoverer_t::running.

VLC_PUBLIC_API char* libvlc_media_discoverer_localized_name

(

libvlc_media_discoverer_t *

p_mdis

)

Get media service discover object its localized name.

Parameters:

media

discover object

Returns:

localized name

References libvlc_media_discoverer_t::p_sd, and services_discovery_GetLocalizedName().

VLC_PUBLIC_API libvlc_media_list_t* libvlc_media_discoverer_media_list

(

libvlc_media_discoverer_t *

p_mdis

)

Get media service discover media list.

Parameters:

p_mdis

media service discover object

Returns:

list of media items

References libvlc_media_list_retain(), and libvlc_media_discoverer_t::p_mlist.

VLC_PUBLIC_API libvlc_media_discoverer_t* libvlc_media_discoverer_new_from_name	(	libvlc_instance_t *	p_inst,
		const char *	psz_name,
		libvlc_exception_t *	p_e
	)

Discover media service by name.

Parameters:

	p_inst	libvlc instance
	psz_name	service name
	p_e	an initialized exception object

Returns:

media discover object

References libvlc_media_list_t::b_read_only, libvlc_media_discoverer_t::catname_to_submedialist, libvlc_event_manager_new(), libvlc_event_manager_register_event_type(), libvlc_exception_raise(), libvlc_media_list_new(), libvlc_media_list_release(), libvlc_MediaDiscovererEnded, libvlc_MediaDiscovererStarted, libvlc_printerr(), libvlc_media_discoverer_t::p_event_manager, libvlc_media_discoverer_t::p_libvlc_instance, libvlc_instance_t::p_libvlc_int, libvlc_media_discoverer_t::p_mlist, libvlc_media_discoverer_t::p_sd, libvlc_media_discoverer_t::running, services_discovery_ended(), services_discovery_EventManager(), services_discovery_item_added(), services_discovery_item_removed(), services_discovery_started(), vlc_dictionary_init(), vlc_event_attach, vlc_sd_Create(), vlc_sd_Start(), vlc_ServicesDiscoveryEnded, vlc_ServicesDiscoveryItemAdded, vlc_ServicesDiscoveryItemRemoved, and vlc_ServicesDiscoveryStarted.

VLC_PUBLIC_API void libvlc_media_discoverer_release

(

libvlc_media_discoverer_t *

p_mdis

)

Release media discover object.

If the reference count reaches 0, then the object will be released.

Parameters:

p_mdis

media service discover object

References libvlc_media_discoverer_t::catname_to_submedialist, i, libvlc_event_manager_release(), libvlc_media_list_release(), libvlc_media_discoverer_t::p_event_manager, libvlc_media_discoverer_t::p_mlist, libvlc_media_discoverer_t::p_sd, vlc_dictionary_all_keys(), vlc_dictionary_clear(), vlc_dictionary_value_for_key(), and vlc_sd_StopAndDestroy().