include/vlc_media_library.h

   1 /*****************************************************************************
   2  * vlc_media_library.h: SQL-based media library
   3  *****************************************************************************
   4  * Copyright (C) 2008-2010 the VideoLAN Team and AUTHORS
   5  * $Id$
   6  *
   7  * Authors: Antoine Lejeune <phytos@videolan.org>
   8  *          Jean-Philippe André <jpeg@videolan.org>
   9  *          Rémi Duraffort <ivoire@videolan.org>
  10  *          Adrien Maglo <magsoft@videolan.org>
  11  *          Srikanth Raju <srikiraju at gmail dot com>
  12  *
  13  * This program is free software; you can redistribute it and/or modify it
  14  * under the terms of the GNU Lesser General Public License as published by
  15  * the Free Software Foundation; either version 2.1 of the License, or
  16  * (at your option) any later version.
  17  *
  18  * This program is distributed in the hope that it will be useful,
  19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  21  * GNU Lesser General Public License for more details.
  22  *
  23  * You should have received a copy of the GNU Lesser General Public License
  24  * along with this program; if not, write to the Free Software Foundation,
  25  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  26  *****************************************************************************/
  27
  28 #ifndef VLC_MEDIA_LIBRARY_H
  29 # define VLC_MEDIA_LIBRARY_H
  30
  31 #include <assert.h>
  32
  33 # ifdef __cplusplus
  34 extern "C" {
  35 # endif
  36
  37 typedef enum vlc_ml_media_type_t
  38 {
  39     VLC_ML_MEDIA_TYPE_UNKNOWN,
  40     VLC_ML_MEDIA_TYPE_VIDEO,
  41     VLC_ML_MEDIA_TYPE_AUDIO,
  42     VLC_ML_MEDIA_TYPE_EXTERNAL,
  43     VLC_ML_MEDIA_TYPE_STREAM,
  44 } vlc_ml_media_type_t;
  45
  46 typedef enum vlc_ml_media_subtype_t
  47 {
  48     VLC_ML_MEDIA_SUBTYPE_UNKNOWN,
  49     VLC_ML_MEDIA_SUBTYPE_SHOW_EPISODE,
  50     VLC_ML_MEDIA_SUBTYPE_MOVIE,
  51     VLC_ML_MEDIA_SUBTYPE_ALBUMTRACK,
  52 } vlc_ml_media_subtype_t;
  53
  54 typedef enum vlc_ml_file_type_t
  55 {
  56     VLC_ML_FILE_TYPE_UNKNOWN,
  57     VLC_ML_FILE_TYPE_MAIN,
  58     VLC_ML_FILE_TYPE_PART,
  59     VLC_ML_FILE_TYPE_SOUNDTRACK,
  60     VLC_ML_FILE_TYPE_SUBTITLE,
  61     VLC_ML_FILE_TYPE_PLAYLIST,
  62 } vlc_ml_file_type_t;
  63
  64 typedef enum vlc_ml_track_type_t
  65 {
  66     VLC_ML_TRACK_TYPE_UNKNOWN,
  67     VLC_ML_TRACK_TYPE_VIDEO,
  68     VLC_ML_TRACK_TYPE_AUDIO,
  69 } vlc_ml_track_type_t;
  70
  71 typedef struct vlc_ml_movie_t
  72 {
  73     char* psz_summary;
  74     char* psz_imdb_id;
  75 } vlc_ml_movie_t;
  76
  77 typedef struct vlc_ml_show_episode_t
  78 {
  79     char* psz_summary;
  80     char* psz_tvdb_id;
  81     uint32_t i_episode_nb;
  82     uint32_t i_season_number;
  83 } vlc_ml_show_episode_t;
  84
  85 typedef struct vlc_ml_show_t
  86 {
  87     int64_t i_id;
  88     char* psz_name;
  89     char* psz_summary;
  90     char* psz_artwork_mrl;
  91     char* psz_tvdb_id;
  92     unsigned int i_release_year;
  93     uint32_t i_nb_episodes;
  94     uint32_t i_nb_seasons;
  95 } vlc_ml_show_t;
  96
  97 typedef struct vlc_ml_album_track_t
  98 {
  99     int64_t i_artist_id;
 100     int64_t i_album_id;
 101     int64_t i_genre_id;
 102
 103     int i_track_nb;
 104     int i_disc_nb;
 105 } vlc_ml_album_track_t;
 106
 107 typedef struct vlc_ml_label_t
 108 {
 109     int64_t i_id;
 110     char* psz_name;
 111 } vlc_ml_label_t;
 112
 113 typedef struct vlc_ml_label_list_t
 114 {
 115     size_t i_nb_items;
 116     vlc_ml_label_t p_items[];
 117 } vlc_ml_label_list_t;
 118
 119 typedef struct vlc_ml_file_t
 120 {
 121     char* psz_mrl;
 122     vlc_ml_file_type_t i_type;
 123     bool b_external;
 124 } vlc_ml_file_t;
 125
 126 typedef struct vlc_ml_file_list_t
 127 {
 128     size_t i_nb_items;
 129     vlc_ml_file_t p_items[];
 130 } vlc_ml_file_list_t;
 131
 132 typedef struct vlc_ml_media_track_t
 133 {
 134     char* psz_codec;
 135     char* psz_language;
 136     char* psz_description;
 137     vlc_ml_track_type_t i_type;
 138     uint32_t i_bitrate;
 139     union
 140     {
 141         struct
 142         {
 143             // Audio
 144             uint32_t i_nbChannels;
 145             uint32_t i_sampleRate;
 146         } a;
 147         struct
 148         {
 149             // Video
 150             uint32_t i_height;
 151             uint32_t i_width;
 152             uint32_t i_sarNum;
 153             uint32_t i_sarDen;
 154             uint32_t i_fpsNum;
 155             uint32_t i_fpsDen;
 156         } v;
 157     };
 158 } vlc_ml_media_track_t;
 159
 160 typedef struct vlc_ml_media_track_list_t
 161 {
 162     size_t i_nb_items;
 163     vlc_ml_media_track_t p_items[];
 164 } vlc_ml_media_track_list_t;
 165
 166 typedef struct vlc_ml_media_t
 167 {
 168     int64_t i_id;
 169
 170     vlc_ml_media_type_t i_type;
 171     vlc_ml_media_subtype_t i_subtype;
 172
 173     vlc_ml_file_list_t* p_files;
 174     vlc_ml_media_track_list_t* p_tracks;
 175
 176     int32_t i_year;
 177     /* Duration in milliseconds */
 178     int64_t i_duration;
 179     uint32_t i_playcount;
 180     time_t i_last_played_date;
 181     char* psz_title;
 182
 183     char* psz_artwork_mrl;
 184     bool b_is_favorite;
 185
 186     union
 187     {
 188         vlc_ml_show_episode_t show_episode;
 189         vlc_ml_movie_t movie;
 190         vlc_ml_album_track_t album_track;
 191     };
 192 } vlc_ml_media_t;
 193
 194 typedef struct vlc_ml_playlist_t
 195 {
 196     int64_t i_id;
 197     char* psz_name;
 198     uint32_t i_creation_date;
 199     char* psz_artwork_mrl;
 200 } vlc_ml_playlist_t;
 201
 202 typedef struct vlc_ml_artist_t
 203 {
 204     int64_t i_id;
 205     char* psz_name;
 206     char* psz_shortbio;
 207     char* psz_artwork_mrl;
 208     char* psz_mb_id;
 209
 210     unsigned int i_nb_album;
 211     unsigned int i_nb_tracks;
 212 } vlc_ml_artist_t;
 213
 214 typedef struct vlc_ml_artist_list_t
 215 {
 216     size_t i_nb_items;
 217     vlc_ml_artist_t p_items[];
 218 } vlc_ml_artist_list_t;
 219
 220 typedef struct vlc_ml_album_t {
 221     int64_t i_id;
 222     char* psz_title;
 223     char* psz_summary;
 224     char* psz_artwork_mrl;
 225     char* psz_artist;
 226     int64_t i_artist_id;
 227
 228     size_t i_nb_tracks;
 229     unsigned int i_duration;
 230     unsigned int i_year;
 231 } vlc_ml_album_t;
 232
 233 typedef struct vlc_ml_genre_t
 234 {
 235     int64_t i_id;
 236     char* psz_name;
 237     size_t i_nb_tracks;
 238 } vlc_ml_genre_t;
 239
 240 typedef struct vlc_ml_media_list_t
 241 {
 242     size_t i_nb_items;
 243     vlc_ml_media_t p_items[];
 244 } vlc_ml_media_list_t;
 245
 246 typedef struct vlc_ml_album_list_t
 247 {
 248     size_t i_nb_items;
 249     vlc_ml_album_t p_items[];
 250 } vlc_ml_album_list_t;
 251
 252 typedef struct vlc_ml_show_list_t
 253 {
 254     size_t i_nb_items;
 255     vlc_ml_show_t p_items[];
 256 } vlc_ml_show_list_t;
 257
 258 typedef struct vlc_ml_genre_list_t
 259 {
 260     size_t i_nb_items;
 261     vlc_ml_genre_t p_items[];
 262 } vlc_ml_genre_list_t;
 263
 264 typedef struct vlc_ml_playlist_list_t
 265 {
 266     size_t i_nb_items;
 267     vlc_ml_playlist_t p_items[];
 268 } vlc_ml_playlist_list_t;
 269
 270 typedef struct vlc_ml_entrypoint_t vlc_ml_entrypoint_t;
 271 struct vlc_ml_entrypoint_t
 272 {
 273     char* psz_mrl; /**< This entrypoint's MRL. Will be NULL if b_present is false */
 274     bool b_present; /**< The presence state for this entrypoint. */
 275     bool b_banned; /**< Will be true if the user required this entrypoint to be excluded */
 276 };
 277
 278 typedef struct vlc_medialibrary_t vlc_medialibrary_t;
 279
 280 vlc_medialibrary_t* libvlc_MlCreate( libvlc_int_t* p_libvlc );
 281 void libvlc_MlRelease( vlc_medialibrary_t* p_ml );
 282
 283 VLC_API vlc_medialibrary_t* vlc_ml_get( vlc_object_t* p_obj ) VLC_USED;
 284 #define vlc_ml_get(x) vlc_ml_get( VLC_OBJECT(x) )
 285
 286 VLC_API void vlc_ml_entrypoints_release( vlc_ml_entrypoint_t* p_list, size_t i_nb_items );
 287
 288 VLC_API void vlc_ml_show_release( vlc_ml_show_t* p_show );
 289 VLC_API void vlc_ml_artist_release( vlc_ml_artist_t* p_artist );
 290 VLC_API void vlc_ml_genre_release( vlc_ml_genre_t* p_genre );
 291 VLC_API void vlc_ml_media_release( vlc_ml_media_t* p_media );
 292 VLC_API void vlc_ml_album_release( vlc_ml_album_t* p_album );
 293 VLC_API void vlc_ml_playlist_release( vlc_ml_playlist_t* p_playlist );
 294
 295 VLC_API void vlc_ml_label_list_release( vlc_ml_label_list_t* p_list );
 296 VLC_API void vlc_ml_file_list_release( vlc_ml_file_list_t* p_list );
 297 VLC_API void vlc_ml_artist_list_release( vlc_ml_artist_list_t* p_list );
 298 VLC_API void vlc_ml_media_list_release( vlc_ml_media_list_t* p_list );
 299 VLC_API void vlc_ml_album_list_release( vlc_ml_album_list_t* p_list );
 300 VLC_API void vlc_ml_show_list_release( vlc_ml_show_list_t* p_list );
 301 VLC_API void vlc_ml_genre_list_release( vlc_ml_genre_list_t* p_list );
 302 VLC_API void vlc_ml_playlist_list_release( vlc_ml_playlist_list_t* p_list );
 303
 304 typedef enum vlc_ml_sorting_criteria_t
 305 {
 306     /*
 307      * Default depends on the entity type:
 308      * - By track number (and disc number) for album tracks
 309      * - Alphabetical order for others
 310      */
 311     VLC_ML_SORTING_DEFAULT,
 312     VLC_ML_SORTING_ALPHA,
 313     VLC_ML_SORTING_DURATION,
 314     VLC_ML_SORTING_INSERTIONDATE,
 315     VLC_ML_SORTING_LASTMODIFICATIONDATE,
 316     VLC_ML_SORTING_RELEASEDATE,
 317     VLC_ML_SORTING_FILESIZE,
 318     VLC_ML_SORTING_ARTIST,
 319     VLC_ML_SORTING_PLAYCOUNT,
 320     VLC_ML_SORTING_ALBUM,
 321     VLC_ML_SORTING_FILENAME,
 322     VLC_ML_SORTING_TRACKNUMBER,
 323 } vlc_ml_sorting_criteria_t;
 324
 325 typedef struct vlc_ml_query_params_t vlc_ml_query_params_t;
 326 struct vlc_ml_query_params_t
 327 {
 328     const char* psz_pattern;
 329     uint32_t i_nbResults;
 330     uint32_t i_offset;
 331     vlc_ml_sorting_criteria_t i_sort;
 332     bool b_desc;
 333 };
 334
 335 static inline vlc_ml_query_params_t vlc_ml_query_params_create()
 336 {
 337     return (vlc_ml_query_params_t) {
 338         .psz_pattern = NULL,
 339         .i_nbResults = 0,
 340         .i_offset = 0,
 341         .i_sort = VLC_ML_SORTING_DEFAULT,
 342         .b_desc = false
 343     };
 344 }
 345
 346 struct vlc_medialibrary_t
 347 {
 348     struct vlc_common_members obj;
 349
 350     module_t *p_module;
 351
 352     void* p_sys;
 353
 354     int (*pf_control)( vlc_medialibrary_t* p_ml, int i_query, ... );
 355     /**
 356      * List some entities from the medialibrary.
 357      *
 358      * \param p_ml The medialibrary module instance.
 359      * \param i_query The type search to be performed. \see vlc_ml_list enumeration
 360      * \param p_params A pointer to a vlc_ml_query_params_t structure, or NULL for
 361      * the default parameters (alphabetical ascending sort, no pagination)
 362      *
 363      * \return VLC_SUCCESS or an error code
 364      *
 365      * Refer to the individual list of vlc_ml_list requests for the additional
 366      * per-query input/ouput parameters values & types
 367      */
 368     int (*pf_list)( vlc_medialibrary_t* p_ml, int i_query,
 369                     const vlc_ml_query_params_t* p_params, ... );
 370
 371     /**
 372      * Get a specific entity by its id.
 373      *
 374      * \return The required entity, or a NULL pointer if couldn't be found.
 375      *
 376      * Refer to the list of queries for the specific return type
 377      */
 378     void* (*pf_get)( vlc_medialibrary_t* p_ml, int i_query, int64_t i_id );
 379 };
 380
 381 enum vlc_ml_control
 382 {
 383     /* Adds a folder to discover through the medialibrary */
 384     VLC_ML_ADD_FOLDER,              /**< arg1: mrl (const char*)  res: can't fail */
 385     VLC_ML_REMOVE_FOLDER,           /**< arg1: mrl (const char*)  res: can't fail */
 386     VLC_ML_BAN_FOLDER,              /**< arg1: mrl (const char*)  res: can't fail */
 387     VLC_ML_UNBAN_FOLDER,            /**< arg1: mrl (const char*)  res: can't fail */
 388     VLC_ML_LIST_FOLDERS,            /**< arg1: entrypoints (vlc_ml_entrypoint_t**); arg2: nb results(size_t*), res: can fail */
 389
 390     /* Pause/resume background operations, such as media discovery & media analysis */
 391     VLC_ML_PAUSE_BACKGROUND,        /**< no args; can't fail */
 392     VLC_ML_RESUME_BACKGROUND,       /**< no args; can't fail */
 393
 394     /* Misc operations */
 395     VLC_ML_CLEAR_HISTORY,           /**< no args; can't fail */
 396
 397     /* Create media */
 398     VLC_ML_NEW_EXTERNAL_MEDIA,      /**< arg1: const char*; arg2(out): vlc_ml_media_t** */
 399     VLC_ML_NEW_STREAM,              /**< arg1: const char*; arg2(out): vlc_ml_media_t** */
 400
 401     /* Media management */
 402     VLC_ML_MEDIA_INCREASE_PLAY_COUNT,       /**< arg1: media id; can fail */
 403     VLC_ML_MEDIA_GET_MEDIA_PLAYBACK_PREF,   /**< arg1: media id; arg2: vlc_ml_playback_pref; arg3: char**; */
 404     VLC_ML_MEDIA_SET_MEDIA_PLAYBACK_PREF,   /**< arg1: media id; arg2: vlc_ml_playback_pref; arg3: const char*; */
 405     VLC_ML_MEDIA_SET_THUMBNAIL,             /**< arg1: media id; arg2: const char*; */
 406     VLC_ML_MEDIA_ADD_EXTERNAL_MRL,          /**< arg1: media id; arg2: const char*; arg3: type(vlc_ml_file_type_t) */
 407 };
 408
 409 /**
 410  * User playback settings.
 411  * All values/units are up to the caller and are not interpreted by the media
 412  * library.
 413  * All values are stored and returned as strings.
 414  * When calling vlc_medialibrary_t::pf_control with vlc_ml_MEDIA_GET_MEDIA_PLAYBACK_PREF,
 415  * the value will be returned stored in the provided char**. If the preference was
 416  * not set yet, NULL will be returned.
 417  * When setting a preference, NULL can be provided as a value to unset it.
 418  */
 419 enum vlc_ml_playback_pref
 420 {
 421     VLC_ML_PLAYBACK_PREF_RATING,
 422     VLC_ML_PLAYBACK_PREF_PROGRESS,
 423     VLC_ML_PLAYBACK_PREF_SPEED,
 424     VLC_ML_PLAYBACK_PREF_TITLE,
 425     VLC_ML_PLAYBACK_PREF_CHAPTER,
 426     VLC_ML_PLAYBACK_PREF_PROGRAM,
 427     VLC_ML_PLAYBACK_PREF_SEEN,
 428     VLC_ML_PLAYBACK_PREF_VIDEO_TRACK,
 429     VLC_ML_PLAYBACK_PREF_ASPECT_RATIO,
 430     VLC_ML_PLAYBACK_PREF_ZOOM,
 431     VLC_ML_PLAYBACK_PREF_CROP,
 432     VLC_ML_PLAYBACK_PREF_DEINTERLACE,
 433     VLC_ML_PLAYBACK_PREF_VIDEO_FILTER,
 434     VLC_ML_PLAYBACK_PREF_AUDIO_TRACK,
 435     VLC_ML_PLAYBACK_PREF_GAIN,
 436     VLC_ML_PLAYBACK_PREF_AUDIO_DELAY,
 437     VLC_ML_PLAYBACK_PREF_SUBTITLE_TRACK,
 438     VLC_ML_PLAYBACK_PREF_SUBTITLE_DELAY,
 439     VLC_ML_PLAYBACK_PREF_APP_SPECIFIC,
 440 };
 441
 442 static inline void vlc_ml_add_folder( vlc_medialibrary_t* p_ml, const char* psz_folder )
 443 {
 444     p_ml->pf_control( p_ml, VLC_ML_ADD_FOLDER, psz_folder );
 445 }
 446
 447 static inline void vlc_ml_remove_folder( vlc_medialibrary_t* p_ml, const char* psz_folder )
 448 {
 449     p_ml->pf_control( p_ml, VLC_ML_REMOVE_FOLDER, psz_folder );
 450 }
 451
 452 static inline void vlc_ml_ban_folder( vlc_medialibrary_t* p_ml, const char* psz_folder )
 453 {
 454     p_ml->pf_control( p_ml, VLC_ML_BAN_FOLDER, psz_folder );
 455 }
 456
 457 static inline void vlc_ml_unban_folder( vlc_medialibrary_t* p_ml, const char* psz_folder )
 458 {
 459     p_ml->pf_control( p_ml, VLC_ML_UNBAN_FOLDER, psz_folder );
 460 }
 461
 462 static inline int vlc_ml_list_folder( vlc_medialibrary_t* p_ml,
 463                                       vlc_ml_entrypoint_t** pp_entrypoints, size_t* p_nb_items )
 464 {
 465     return p_ml->pf_control( p_ml, VLC_ML_LIST_FOLDERS, pp_entrypoints, p_nb_items );
 466 }
 467
 468 static inline void vlc_ml_pause_background( vlc_medialibrary_t* p_ml )
 469 {
 470     p_ml->pf_control( p_ml, VLC_ML_PAUSE_BACKGROUND );
 471 }
 472
 473 static inline void vlc_ml_resume_background( vlc_medialibrary_t* p_ml )
 474 {
 475     p_ml->pf_control( p_ml, VLC_ML_RESUME_BACKGROUND );
 476 }
 477
 478 static inline void vlc_ml_clear_history( vlc_medialibrary_t* p_ml )
 479 {
 480     p_ml->pf_control( p_ml, VLC_ML_CLEAR_HISTORY );
 481 }
 482
 483 static inline vlc_ml_media_t* vlc_ml_new_external_media( vlc_medialibrary_t* p_ml, const char* psz_mrl )
 484 {
 485     vlc_ml_media_t* res;
 486     if ( p_ml->pf_control( p_ml, VLC_ML_NEW_EXTERNAL_MEDIA, psz_mrl, &res ) != VLC_SUCCESS )
 487         return NULL;
 488     return res;
 489 }
 490
 491 static inline vlc_ml_media_t* vlc_ml_new_stream( vlc_medialibrary_t* p_ml, const char* psz_mrl )
 492 {
 493     vlc_ml_media_t* res;
 494     if ( p_ml->pf_control( p_ml, VLC_ML_NEW_STREAM, psz_mrl, &res ) != VLC_SUCCESS )
 495         return NULL;
 496     return res;
 497 }
 498
 499 static inline int vlc_ml_media_increase_playcount( vlc_medialibrary_t* p_ml, int64_t i_media_id )
 500 {
 501     return p_ml->pf_control( p_ml, VLC_ML_MEDIA_INCREASE_PLAY_COUNT, i_media_id );
 502 }
 503
 504 static inline int vlc_ml_media_get_playback_pref( vlc_medialibrary_t* p_ml, int64_t i_media_id, int i_pref, char** ppsz_result )
 505 {
 506     return p_ml->pf_control( p_ml, VLC_ML_MEDIA_GET_MEDIA_PLAYBACK_PREF, i_media_id, i_pref, ppsz_result );
 507 }
 508
 509 static inline int vlc_ml_media_set_playback_pref( vlc_medialibrary_t* p_ml, int64_t i_media_id, int i_pref, const char* psz_value )
 510 {
 511     return p_ml->pf_control( p_ml, VLC_ML_MEDIA_SET_MEDIA_PLAYBACK_PREF, i_media_id, i_pref, psz_value );
 512 }
 513
 514 static inline int vlc_ml_media_set_thumbnail( vlc_medialibrary_t* p_ml, int64_t i_media_id, const char* psz_mrl )
 515 {
 516     return p_ml->pf_control( p_ml, VLC_ML_MEDIA_SET_THUMBNAIL, i_media_id, psz_mrl );
 517 }
 518
 519 static inline int vlc_ml_media_add_external_mrl( vlc_medialibrary_t* p_ml, int64_t i_media_id,
 520                                                  const char* psz_mrl, int i_type )
 521 {
 522     return p_ml->pf_control( p_ml, VLC_ML_MEDIA_ADD_EXTERNAL_MRL, i_media_id, psz_mrl, i_type );
 523 }
 524
 525 enum vlc_ml_get_queries
 526 {
 527     VLC_ML_GET_MEDIA,           /**< arg1: Media    ID; ret: vlc_ml_media_t*    */
 528     VLC_ML_GET_ALBUM,           /**< arg1: Album    ID; ret: vlc_ml_album_t*    */
 529     VLC_ML_GET_ARTIST,          /**< arg1: Artist   ID; ret: vlc_ml_artist_t*   */
 530     VLC_ML_GET_GENRE,           /**< arg1: Genre    ID; ret: vlc_ml_genre_t*    */
 531     VLC_ML_GET_SHOW,            /**< arg1: Show     ID; ret: vlc_ml_show_t*     */
 532     VLC_ML_GET_PLAYLIST,        /**< arg1: Playlist ID; ret: vlc_ml_playlist_t* */
 533 };
 534
 535 static inline vlc_ml_media_t* vlc_ml_get_media( vlc_medialibrary_t* p_ml, int64_t i_media_id )
 536 {
 537     return (vlc_ml_media_t*)p_ml->pf_get( p_ml, VLC_ML_GET_MEDIA, i_media_id );
 538 }
 539
 540 static inline vlc_ml_album_t* vlc_ml_get_album( vlc_medialibrary_t* p_ml, int64_t i_album_id )
 541 {
 542     return (vlc_ml_album_t*)p_ml->pf_get( p_ml, VLC_ML_GET_ALBUM, i_album_id );
 543 }
 544
 545 static inline vlc_ml_artist_t* vlc_ml_get_artist( vlc_medialibrary_t* p_ml, int64_t i_artist_id )
 546 {
 547     return (vlc_ml_artist_t*)p_ml->pf_get( p_ml, VLC_ML_GET_ARTIST, i_artist_id );
 548 }
 549
 550 static inline vlc_ml_genre_t* vlc_ml_get_genre( vlc_medialibrary_t* p_ml, int64_t i_genre_id )
 551 {
 552     return (vlc_ml_genre_t*)p_ml->pf_get( p_ml, VLC_ML_GET_GENRE, i_genre_id );
 553 }
 554
 555 static inline vlc_ml_show_t* vlc_ml_get_show( vlc_medialibrary_t* p_ml, int64_t i_show_id )
 556 {
 557     return (vlc_ml_show_t*)p_ml->pf_get( p_ml, VLC_ML_GET_SHOW, i_show_id );
 558 }
 559
 560 static inline vlc_ml_playlist_t* vlc_ml_get_playlist( vlc_medialibrary_t* p_ml, int64_t i_playlist_id )
 561 {
 562     return (vlc_ml_playlist_t*)p_ml->pf_get( p_ml, VLC_ML_GET_PLAYLIST, i_playlist_id );
 563 }
 564
 565 enum vlc_ml_list_queries
 566 {
 567     /* General listing: */
 568
 569     VLC_ML_LIST_VIDEOS,           /**< arg1 (out): vlc_ml_media_list_t**                            */
 570     VLC_ML_COUNT_VIDEOS,          /**< arg1 (out): size_t*                                          */
 571     VLC_ML_LIST_AUDIOS,           /**< arg1 (out): vlc_ml_media_list_t**                            */
 572     VLC_ML_COUNT_AUDIOS,          /**< arg1 (out): size_t*                                          */
 573     VLC_ML_LIST_ALBUMS,           /**< arg1 (out): vlc_ml_album_list_t**                            */
 574     VLC_ML_COUNT_ALBUMS,          /**< arg1 (out): size_t*                                          */
 575     VLC_ML_LIST_GENRES,           /**< arg1 (out): vlc_ml_genre_list_t**                            */
 576     VLC_ML_COUNT_GENRES,          /**< arg1 (out): size_t*                                          */
 577     VLC_ML_LIST_ARTISTS,          /**< arg1 bool: includeAll; arg2 (out): vlc_ml_genre_list_t**     */
 578     VLC_ML_COUNT_ARTISTS,         /**< arg1 bool: includeAll; arg2 (out): size_t*                   */
 579     VLC_ML_LIST_SHOWS,            /**< arg1 (out): vlc_ml_show_list_t**                             */
 580     VLC_ML_COUNT_SHOWS,           /**< arg1 (out): size_t*                                          */
 581     VLC_ML_LIST_PLAYLISTS,        /**< arg1 (out): vlc_ml_playlist_list_t**                         */
 582     VLC_ML_COUNT_PLAYLISTS,       /**< arg1 (out): size_t*                                          */
 583     VLC_ML_LIST_HISTORY,          /**< arg1 (out): vlc_ml_media_list_t**                            */
 584     VLC_ML_LIST_STREAM_HISTORY,   /**< arg1 (out): vlc_ml_media_list_t**                            */
 585
 586     /* Album specific listings */
 587     VLC_ML_LIST_ALBUM_TRACKS,     /**< arg1: The album id. arg2 (out): vlc_ml_media_list_t**  */
 588     VLC_ML_COUNT_ALBUM_TRACKS,    /**< arg1: The album id. arg2 (out): size_t*  */
 589     VLC_ML_LIST_ALBUM_ARTISTS,    /**< arg1: The album id. arg2 (out): vlc_ml_album_list_t**  */
 590     VLC_ML_COUNT_ALBUM_ARTISTS,    /**< arg1: The album id. arg2 (out): size_t*  */
 591
 592     /* Artist specific listings */
 593     VLC_ML_LIST_ARTIST_ALBUMS,  /**< arg1: The artist id. arg2(out): vlc_ml_album_list_t**    */
 594     VLC_ML_COUNT_ARTIST_ALBUMS, /**< arg1: The artist id. arg2(out): size_t*              */
 595     VLC_ML_LIST_ARTIST_TRACKS,  /**< arg1: The artist id. arg2(out): vlc_ml_media_list_t**    */
 596     VLC_ML_COUNT_ARTIST_TRACKS, /**< arg1: The artist id. arg2(out): size_t*              */
 597
 598     /* Genre specific listings */
 599     VLC_ML_LIST_GENRE_ARTISTS,    /**< arg1: genre id;  arg2 (out): vlc_ml_artist_list_t**  */
 600     VLC_ML_COUNT_GENRE_ARTISTS,   /**< arg1: genre id;  arg2 (out): size_t*             */
 601     VLC_ML_LIST_GENRE_TRACKS,     /**< arg1: genre id;  arg2 (out): vlc_ml_media_list_t**   */
 602     VLC_ML_COUNT_GENRE_TRACKS,    /**< arg1: genre id;  arg2 (out): size_t*             */
 603     VLC_ML_LIST_GENRE_ALBUMS,     /**< arg1: genre id;  arg2 (out): vlc_ml_album_list_t**   */
 604     VLC_ML_COUNT_GENRE_ALBUMS,    /**< arg1: genre id;  arg2 (out): size_t*             */
 605
 606     /* Show specific listings */
 607     VLC_ML_LIST_SHOW_EPISODES,    /**< arg1: show id; arg2(out): vlc_ml_media_list_t**  */
 608     VLC_ML_COUNT_SHOW_EPISODES,   /**< arg1: show id; arg2(out): size_t*                */
 609
 610     /* Media specific listings */
 611     VLC_ML_LIST_MEDIA_LABELS,     /**< arg1: media id;  arg2 (out): vlc_ml_label_list_t**    */
 612     VLC_ML_COUNT_MEDIA_LABELS,    /**< arg1: media id;  arg2 (out): size_t*              */
 613
 614     /* Playlist specific listings */
 615     VLC_ML_LIST_PLAYLIST_MEDIA,   /**< arg1: playlist id; arg2 (out): vlc_ml_media_list_t** */
 616     VLC_ML_COUNT_PLAYLIST_MEDIA,  /**< arg1: playlist id; arg2 (out): size_t* */
 617
 618     /* Children entities listing */
 619     VLC_ML_LIST_MEDIA_OF,         /**< arg1: parent entity type; arg2: parent entity id; arg3(out): ml_media_list_t* */
 620     VLC_ML_COUNT_MEDIA_OF,        /**< arg1: parent entity type; arg2: parent entity id; arg3(out): size_t* */
 621     VLC_ML_LIST_ARTISTS_OF,       /**< arg1: parent entity type; arg2: parent entity id; arg3(out): ml_artist_list_t* */
 622     VLC_ML_COUNT_ARTISTS_OF,      /**< arg1: parent entity type; arg2: parent entity id; arg3(out): size_t* */
 623     VLC_ML_LIST_ALBUMS_OF,        /**< arg1: parent entity type; arg2: parent entity id; arg3(out): ml_album_list_t* */
 624     VLC_ML_COUNT_ALBUMS_OF,       /**< arg1: parent entity type; arg2: parent entity id; arg3(out): size_t* */
 625 };
 626
 627 enum vlc_ml_parent_type
 628 {
 629     VLC_ML_PARENT_ALBUM,
 630     VLC_ML_PARENT_ARTIST,
 631     VLC_ML_PARENT_SHOW,
 632     VLC_ML_PARENT_GENRE,
 633     VLC_ML_PARENT_PLAYLIST,
 634 };
 635
 636 static inline vlc_ml_media_list_t* vlc_ml_list_media_of( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int i_parent_type, int64_t i_parent_id )
 637 {
 638     vlc_assert( p_ml != NULL );
 639     vlc_ml_media_list_t* res;
 640     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_MEDIA_OF, params, i_parent_type, i_parent_id, &res ) != VLC_SUCCESS )
 641         return NULL;
 642     return res;
 643 }
 644
 645 static inline size_t vlc_ml_count_media_of( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int i_parent_type, int64_t i_parent_id )
 646 {
 647     vlc_assert( p_ml != NULL );
 648     size_t res;
 649     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_MEDIA_OF, params, i_parent_type, i_parent_id, &res ) )
 650         return 0;
 651     return res;
 652 }
 653
 654 static inline vlc_ml_artist_list_t* vlc_ml_list_artist_of( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int i_parent_type, int64_t i_parent_id )
 655 {
 656     vlc_assert( p_ml != NULL );
 657     vlc_ml_artist_list_t* res;
 658     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_ARTISTS_OF, params, i_parent_type, i_parent_id, &res ) != VLC_SUCCESS )
 659         return NULL;
 660     return res;
 661 }
 662
 663 static inline size_t vlc_ml_count_artists_of( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int i_parent_type, int64_t i_parent_id )
 664 {
 665     vlc_assert( p_ml != NULL );
 666     size_t res;
 667     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_ARTISTS_OF, params, i_parent_type, i_parent_id, &res ) )
 668         return 0;
 669     return res;
 670 }
 671
 672 static inline vlc_ml_album_list_t* vlc_ml_list_albums_of( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int i_parent_type, int64_t i_parent_id )
 673 {
 674     vlc_assert( p_ml != NULL );
 675     vlc_ml_album_list_t* res;
 676     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_ALBUMS_OF, params, i_parent_type, i_parent_id, &res ) != VLC_SUCCESS )
 677         return NULL;
 678     return res;
 679 }
 680
 681 static inline size_t vlc_ml_count_albums_of( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int i_parent_type, int64_t i_parent_id )
 682 {
 683     vlc_assert( p_ml != NULL );
 684     size_t res;
 685     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_ALBUMS_OF, params, i_parent_type, i_parent_id, &res ) )
 686         return 0;
 687     return res;
 688 }
 689
 690 static inline vlc_ml_media_list_t* vlc_ml_list_album_tracks( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_album_id )
 691 {
 692     vlc_assert( p_ml != NULL );
 693     vlc_ml_media_list_t* res;
 694     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_ALBUM_TRACKS, params, i_album_id, &res ) != VLC_SUCCESS )
 695         return NULL;
 696     return res;
 697 }
 698
 699 static inline size_t vlc_ml_count_album_tracks( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_album_id )
 700 {
 701     vlc_assert( p_ml != NULL );
 702     size_t count;
 703     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_ALBUM_TRACKS, params, i_album_id, &count ) != VLC_SUCCESS )
 704         return 0;
 705     return count;
 706 }
 707
 708 static inline vlc_ml_media_list_t* vlc_ml_list_album_artists( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_album_id )
 709 {
 710     vlc_assert( p_ml != NULL );
 711     vlc_ml_media_list_t* res;
 712     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_ALBUM_ARTISTS, params, i_album_id, &res ) != VLC_SUCCESS )
 713         return NULL;
 714     return res;
 715 }
 716
 717 static inline size_t vlc_ml_count_album_artists( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_album_id )
 718 {
 719     vlc_assert( p_ml != NULL );
 720     size_t count;
 721     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_ALBUM_ARTISTS, params, i_album_id, &count ) != VLC_SUCCESS )
 722         return 0;
 723     return count;
 724 }
 725
 726 static inline vlc_ml_album_list_t* vlc_ml_list_artist_albums( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_artist_id )
 727 {
 728     vlc_assert( p_ml != NULL );
 729     vlc_ml_album_list_t* res;
 730     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_ARTIST_ALBUMS, params, i_artist_id, &res ) != VLC_SUCCESS )
 731         return NULL;
 732     return res;
 733 }
 734
 735 static inline size_t vlc_ml_count_artist_albums( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_artist_id )
 736 {
 737     vlc_assert( p_ml != NULL );
 738     size_t count;
 739     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_ARTIST_ALBUMS, params, i_artist_id, &count ) != VLC_SUCCESS )
 740         return 0;
 741     return count;
 742 }
 743
 744 static inline vlc_ml_media_list_t* vlc_ml_list_artist_tracks( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_artist_id )
 745 {
 746     vlc_assert( p_ml != NULL );
 747     vlc_ml_media_list_t* res;
 748     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_ARTIST_TRACKS, params, i_artist_id, &res ) != VLC_SUCCESS )
 749         return NULL;
 750     return res;
 751 }
 752
 753 static inline size_t vlc_ml_count_artist_tracks( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_artist_id )
 754 {
 755     vlc_assert( p_ml != NULL );
 756     size_t count;
 757     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_ARTIST_TRACKS, params, i_artist_id, &count ) != VLC_SUCCESS )
 758         return 0;
 759     return count;
 760 }
 761
 762 static inline vlc_ml_media_list_t* vlc_ml_list_video_media( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 763 {
 764     vlc_assert( p_ml != NULL );
 765     vlc_ml_media_list_t* res;
 766     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_VIDEOS, params, &res ) != VLC_SUCCESS )
 767         return NULL;
 768     return res;
 769 }
 770
 771 static inline size_t vlc_ml_count_video_media( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 772 {
 773     vlc_assert( p_ml != NULL );
 774     size_t count;
 775     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_VIDEOS, params, &count ) != VLC_SUCCESS )
 776         return 0;
 777     return count;
 778 }
 779
 780 static inline vlc_ml_media_list_t* vlc_ml_list_audio_media( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 781 {
 782     vlc_assert( p_ml != NULL );
 783     vlc_ml_media_list_t* res;
 784     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_AUDIOS, params, &res ) != VLC_SUCCESS )
 785         return NULL;
 786     return res;
 787 }
 788
 789 static inline size_t vlc_ml_count_audio_media( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 790 {
 791     vlc_assert( p_ml != NULL );
 792     size_t count;
 793     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_AUDIOS, params, &count ) != VLC_SUCCESS )
 794         return 0;
 795     return count;
 796 }
 797
 798 static inline vlc_ml_album_list_t* vlc_ml_list_albums( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 799 {
 800     vlc_assert( p_ml != NULL );
 801     vlc_ml_album_list_t* res;
 802     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_ALBUMS, params, &res ) != VLC_SUCCESS )
 803         return NULL;
 804     return res;
 805 }
 806
 807 static inline size_t vlc_ml_count_albums( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 808 {
 809     vlc_assert( p_ml != NULL );
 810     size_t count;
 811     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_ALBUMS, params, &count ) != VLC_SUCCESS )
 812         return 0;
 813     return count;
 814 }
 815
 816 static inline vlc_ml_genre_list_t* vlc_ml_list_genres( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 817 {
 818     vlc_assert( p_ml != NULL );
 819     vlc_ml_genre_list_t* res;
 820     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_GENRES, params, &res ) != VLC_SUCCESS )
 821         return NULL;
 822     return res;
 823 }
 824
 825 static inline size_t vlc_ml_count_genres( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 826 {
 827     vlc_assert( p_ml != NULL );
 828     size_t count;
 829     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_GENRES, params, &count ) != VLC_SUCCESS )
 830         return 0;
 831     return count;
 832 }
 833
 834 /**
 835  * @brief vlc_ml_list_artists
 836  * @param params Query parameters, or NULL for the default
 837  * @param b_include_all True if you wish to fetch artists without at least one album.
 838  * @return
 839  */
 840 static inline vlc_ml_artist_list_t* vlc_ml_list_artists( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, bool b_include_all )
 841 {
 842     vlc_assert( p_ml != NULL );
 843     vlc_ml_artist_list_t* res;
 844     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_ARTISTS, params, (int)b_include_all, &res ) != VLC_SUCCESS )
 845         return NULL;
 846     return res;
 847 }
 848
 849 static inline size_t vlc_ml_count_artists( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, bool includeAll )
 850 {
 851     vlc_assert( p_ml != NULL );
 852     size_t count;
 853     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_ARTISTS, params, includeAll, &count ) != VLC_SUCCESS )
 854         return 0;
 855     return count;
 856 }
 857
 858 static inline vlc_ml_show_list_t* vlc_ml_list_shows( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 859 {
 860     vlc_assert( p_ml != NULL );
 861     vlc_ml_show_list_t* res;
 862     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_SHOWS, params, &res ) != VLC_SUCCESS )
 863         return NULL;
 864     return res;
 865 }
 866
 867 static inline size_t vlc_ml_count_shows( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 868 {
 869     vlc_assert( p_ml != NULL );
 870     size_t count;
 871     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_SHOWS, params, &count ) != VLC_SUCCESS )
 872         return 0;
 873     return count;
 874 }
 875
 876 static inline vlc_ml_media_list_t* vlc_ml_list_genre_artists( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_genre_id )
 877 {
 878     vlc_assert( p_ml != NULL );
 879     vlc_ml_media_list_t* res;
 880     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_GENRE_ARTISTS, params, i_genre_id, &res ) != VLC_SUCCESS )
 881         return NULL;
 882     return res;
 883 }
 884
 885 static inline size_t vlc_ml_count_genre_artists( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_genre_id )
 886 {
 887     vlc_assert( p_ml != NULL );
 888     size_t count;
 889     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_GENRE_ARTISTS, params, i_genre_id, &count ) != VLC_SUCCESS )
 890         return 0;
 891     return count;
 892 }
 893
 894 static inline vlc_ml_media_list_t* vlc_ml_list_genre_tracks( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_genre_id )
 895 {
 896     vlc_assert( p_ml != NULL );
 897     vlc_ml_media_list_t* res;
 898     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_GENRE_TRACKS, params, i_genre_id, &res ) != VLC_SUCCESS )
 899         return NULL;
 900     return res;
 901 }
 902
 903 static inline size_t vlc_ml_count_genre_tracks( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_genre_id )
 904 {
 905     vlc_assert( p_ml != NULL );
 906     size_t count;
 907     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_GENRE_TRACKS, params, i_genre_id, &count ) != VLC_SUCCESS )
 908         return 0;
 909     return count;
 910 }
 911
 912 static inline vlc_ml_album_list_t* vlc_ml_list_genre_albums( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_genre_id )
 913 {
 914     vlc_assert( p_ml != NULL );
 915     vlc_ml_album_list_t* res;
 916     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_GENRE_ALBUMS, params, i_genre_id, &res ) != VLC_SUCCESS )
 917         return NULL;
 918     return res;
 919 }
 920
 921 static inline size_t vlc_ml_count_genre_albums( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_genre_id )
 922 {
 923     vlc_assert( p_ml != NULL );
 924     size_t count;
 925     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_GENRE_ALBUMS, params, i_genre_id, &count ) != VLC_SUCCESS )
 926         return 0;
 927     return count;
 928 }
 929
 930 static inline vlc_ml_media_list_t* vlc_ml_list_show_episodes( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_show_id )
 931 {
 932     vlc_assert( p_ml != NULL );
 933     vlc_ml_media_list_t* res;
 934     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_SHOW_EPISODES, params, i_show_id, &res ) != VLC_SUCCESS )
 935         return NULL;
 936     return res;
 937 }
 938
 939 static inline size_t vlc_ml_count_show_episodes( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_show_id )
 940 {
 941     vlc_assert( p_ml != NULL );
 942     size_t count;
 943     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_GENRE_ALBUMS, params, i_show_id, &count ) != VLC_SUCCESS )
 944         return 0;
 945     return count;
 946 }
 947
 948 static inline vlc_ml_label_list_t* vlc_ml_list_media_labels( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_media_id )
 949 {
 950     vlc_assert( p_ml != NULL );
 951     vlc_ml_label_list_t* res;
 952     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_MEDIA_LABELS, params, i_media_id, &res ) != VLC_SUCCESS )
 953         return NULL;
 954     return res;
 955 }
 956
 957 static inline size_t vlc_ml_count_media_labels( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params, int64_t i_media_id )
 958 {
 959     vlc_assert( p_ml != NULL );
 960     size_t count;
 961     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_MEDIA_LABELS, params, i_media_id, &count ) != VLC_SUCCESS )
 962         return 0;
 963     return count;
 964 }
 965
 966 static inline vlc_ml_media_list_t* vlc_ml_list_history( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 967 {
 968     vlc_assert( p_ml != NULL );
 969     vlc_ml_media_list_t* res;
 970     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_HISTORY, params, &res ) != VLC_SUCCESS )
 971         return NULL;
 972     return res;
 973 }
 974
 975 static inline vlc_ml_media_list_t* vlc_ml_list_stream_history( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 976 {
 977     vlc_assert( p_ml != NULL );
 978     vlc_ml_media_list_t* res;
 979     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_STREAM_HISTORY, params, &res ) != VLC_SUCCESS )
 980         return NULL;
 981     return res;
 982 }
 983
 984 static inline vlc_ml_playlist_list_t* vlc_ml_list_playlists( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 985 {
 986     vlc_assert( p_ml != NULL );
 987     vlc_ml_playlist_list_t* res;
 988     if ( p_ml->pf_list( p_ml, VLC_ML_LIST_PLAYLISTS, params, &res ) != VLC_SUCCESS )
 989         return NULL;
 990     return res;
 991 }
 992
 993 static inline size_t vlc_ml_count_playlists( vlc_medialibrary_t* p_ml, const vlc_ml_query_params_t* params )
 994 {
 995     vlc_assert( p_ml != NULL );
 996     size_t count;
 997     if ( p_ml->pf_list( p_ml, VLC_ML_COUNT_PLAYLISTS, params, &count ) != VLC_SUCCESS )
 998         return 0;
 999     return count;
1000 }
1001
1002 #ifdef __cplusplus
1003 }
1004 #endif /* C++ */
1005
1006 #ifndef __cplusplus
1007 # define vlc_ml_release_obj( OBJ ) _Generic( ( OBJ ), \
1008     vlc_ml_show_t*: vlc_ml_show_release, \
1009     vlc_ml_artist_t*: vlc_ml_artist_release, \
1010     vlc_ml_album_t*: vlc_ml_album_release, \
1011     vlc_ml_genre_t*: vlc_ml_genre_release, \
1012     vlc_ml_media_t*: vlc_ml_media_release, \
1013     vlc_ml_playlist_t*: vlc_ml_playlist_release, \
1014     vlc_ml_label_list_t*: vlc_ml_label_list_release, \
1015     vlc_ml_file_list_t*: vlc_ml_file_list_release, \
1016     vlc_ml_artist_list_t*: vlc_ml_artist_list_release, \
1017     vlc_ml_media_list_t*: vlc_ml_media_list_release, \
1018     vlc_ml_album_list_t*: vlc_ml_album_list_release, \
1019     vlc_ml_show_list_t*: vlc_ml_show_list_release, \
1020     vlc_ml_genre_list_t*: vlc_ml_genre_list_release, \
1021     vlc_ml_playlist_list_t*: vlc_ml_playlist_list_release \
1022     )( OBJ )
1023 #else
1024 static inline void vlc_ml_release_obj( vlc_ml_show_t* show ) { vlc_ml_show_release( show ); }
1025 static inline void vlc_ml_release_obj( vlc_ml_artist_t* artist ) { vlc_ml_artist_release( artist ); }
1026 static inline void vlc_ml_release_obj( vlc_ml_album_t* album ) { vlc_ml_album_release( album ); }
1027 static inline void vlc_ml_release_obj( vlc_ml_genre_t* genre ) { vlc_ml_genre_release( genre ); }
1028 static inline void vlc_ml_release_obj( vlc_ml_media_t* media ) { vlc_ml_media_release( media ); }
1029 static inline void vlc_ml_release_obj( vlc_ml_playlist_t* playlist ) { vlc_ml_playlist_release( playlist ); }
1030 static inline void vlc_ml_release_obj( vlc_ml_label_list_t* list ) { vlc_ml_label_list_release( list ); }
1031 static inline void vlc_ml_release_obj( vlc_ml_file_list_t* list ) { vlc_ml_file_list_release( list ); }
1032 static inline void vlc_ml_release_obj( vlc_ml_artist_list_t* list ) { vlc_ml_artist_list_release( list ); }
1033 static inline void vlc_ml_release_obj( vlc_ml_media_list_t* list ) { vlc_ml_media_list_release( list ); }
1034 static inline void vlc_ml_release_obj( vlc_ml_album_list_t* list ) { vlc_ml_album_list_release( list ); }
1035 static inline void vlc_ml_release_obj( vlc_ml_show_list_t* list ) { vlc_ml_show_list_release( list ); }
1036 static inline void vlc_ml_release_obj( vlc_ml_genre_list_t* list ) { vlc_ml_genre_list_release( list ); }
1037 static inline void vlc_ml_release_obj( vlc_ml_playlist_list_t* list ) { vlc_ml_playlist_list_release( list ); }
1038 #endif
1039
1040 #endif /* VLC_MEDIA_LIBRARY_H */