X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=include%2Fvlc_services_discovery.h;h=d647b61543c515f125304d7ef3a57a20187d90e2;hb=9cb16e8f71a79a2cd2a012cca0923a3660a6d32c;hp=6a6e6cc445838801fea9578b5d70484b430b009b;hpb=1b09c02c7e8162abb14d6f30980b09c7d7b34200;p=vlc diff --git a/include/vlc_services_discovery.h b/include/vlc_services_discovery.h index 6a6e6cc445..d647b61543 100644 --- a/include/vlc_services_discovery.h +++ b/include/vlc_services_discovery.h @@ -21,12 +21,13 @@ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. *****************************************************************************/ -#if !defined( __LIBVLC__ ) - #error You are not libvlc or one of its plugins. You cannot include this file -#endif +#ifndef VLC_SERVICES_DISCOVERY_H_ +#define VLC_SERVICES_DISCOVERY_H_ -#ifndef _VLC_SERVICES_DISCOVERY_H_ -#define _VLC_SERVICES_DISCOVERY_H_ +/** + * \file + * This file functions and structures for service discovery in vlc + */ # ifdef __cplusplus extern "C" { @@ -42,41 +43,44 @@ extern "C" { struct services_discovery_t { VLC_COMMON_MEMBERS - char * psz_module; module_t * p_module; - char * psz_localized_name; /* Accessed through Setters for non class function */ vlc_event_manager_t event_manager; /* Accessed through Setters for non class function */ services_discovery_sys_t *p_sys; - void (*pf_run) ( services_discovery_t *); }; - /*********************************************************************** * Service Discovery ***********************************************************************/ /* Get the services discovery modules names to use in Create(), in a null * terminated string array. Array and string must be freed after use. */ -VLC_EXPORT( char **, __services_discovery_GetServicesNames, ( vlc_object_t * p_super, char ***pppsz_longnames ) ); -#define services_discovery_GetServicesNames(a,b) \ - __services_discovery_GetServicesNames(VLC_OBJECT(a),b) +VLC_EXPORT( char **, vlc_sd_GetNames, ( char ***pppsz_longnames ) ); /* Creation of a service_discovery object */ -VLC_EXPORT( services_discovery_t *, services_discovery_Create, ( vlc_object_t * p_super, const char * psz_service_name ) ); -VLC_EXPORT( void, services_discovery_Destroy, ( services_discovery_t * p_this ) ); -VLC_EXPORT( int, services_discovery_Start, ( services_discovery_t * p_this ) ); -VLC_EXPORT( void, services_discovery_Stop, ( services_discovery_t * p_this ) ); +VLC_EXPORT( services_discovery_t *, vlc_sd_Create, ( vlc_object_t * ) ); +VLC_EXPORT( bool, vlc_sd_Start, ( services_discovery_t *, const char * ) ); +VLC_EXPORT( void, vlc_sd_Stop, ( services_discovery_t * ) ); + +static inline void vlc_sd_Destroy( services_discovery_t *p_sd ) +{ + vlc_object_release( VLC_OBJECT(p_sd) ); +} + +static inline void vlc_sd_StopAndDestroy( services_discovery_t * p_this ) +{ + vlc_sd_Stop( p_this ); + vlc_sd_Destroy( p_this ); +} /* Read info from discovery object */ VLC_EXPORT( char *, services_discovery_GetLocalizedName, ( services_discovery_t * p_this ) ); -/* Receive event notification (prefered way to get new items) */ +/* Receive event notification (preferred way to get new items) */ VLC_EXPORT( vlc_event_manager_t *, services_discovery_EventManager, ( services_discovery_t * p_this ) ); /* Used by services_discovery to post update about their items */ -VLC_EXPORT( void, services_discovery_SetLocalizedName, ( services_discovery_t * p_this, const char * ) ); /* About the psz_category, it is a legacy way to add info to the item, * for more options, directly set the (meta) data on the input item */ VLC_EXPORT( void, services_discovery_AddItem, ( services_discovery_t * p_this, input_item_t * p_item, const char * psz_category ) );