mmplaylist_open()

Synopsis:

#include <mm/mmplaylist.h>

mmplaylist_t* mmplaylist_open( 
                  const char *base_name, 
                  const char *playlist_name, 
                  mmplaylist_validation_mode_t validation_mode, 
                  mmplaylist_validation_fn_t *validate_fn, 
                  void *cbk_data )

Arguments:

base_name: A string containing the base directory for the mediastore that contains this playlist.

playlist_name: A string that contains the full path to the playlist. This path can be an absolute filepath or a URL.

validation_mode: The method that libmmplaylist must use to resolve playlist entries (see mmplaylist_validation_mode_t for the list of acceptable values)

validate_fn: Callback function to use for validating playlist entries. This optional parameter can be set to NULL, in which case the library uses stat() to validate entries. Also, entry validation is done only when validation_mode is set to MMPLAYLIST_ENTRY_VALIDATE.

cbk_data: Data for the callback function. This data gets passed unmodified to the callback function. The data can be NULL.

Library:

libmmplaylist

Description:

Open a session on a playlist. This function creates and returns a handle to represent the new playlist session. Internally, the function queries the available plugins to identify which ones support this playlist format. If multiple plugins support the format, the highest-ranked one is selected for use with this session.

Returns:

A handle to a playlist, if the playlist is supported

NULL on error