mme_playlist_generate_similar()

Generate a playlist like an existing playlist

This function is no yet fully implemented, and returns an ENOSUP error if it is called.

Synopsis:

#include <mme/playlist.h>

int mme_playlist_generate_similar( mme_hdl_t *hdl,
                                   const char *name
                                   uint64_t fid,
                                   uint64_t msid,
                                   unsigned max_entries,
                                   uint32_t flags,
                                   uint32_t *plid );

Arguments:

hdl
An MME connection handle.
name
A pointer to a text name to display for the new playlist.
fid
The ID of the file to use as a seed for the new playlist.
msid
The ID of the mediastore from which to select tracks to place in the playlist. See Playlists and mediastores below.
max_entries
The maximum number of entries that can be put in the new playlist.
flags
For future use.
plid
The playlist ID of the new playlist.

Library:

mme

Description:

The function mme_playlist_generate_similar() generates a playlist from files similar to the seed file.

Playlists and mediastores

The msid argument determines which mediastores mme_playlist_generate_similar() uses to generate a playlist. Possible values and behaviors are as follows:

>0
Build a playlist from tracks on the specified mediastore.
If the MME prunes the mediastore from its database, it also prunes the playlist.
=0
Build a playlist from tracks on all active mediastores.
The client application is responsible for pruning the playlist when it is no longer needed; the MME does not prune the playlist from the database, because it is not associated with a specific mediastore.

Events

None delivered.

Blocking and validation

This function validates the mediastore ID, and runs to completion.

Returns:

>0
Success.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

MME_PLAYLIST_*, mme_playlist_close(), mme_playlist_create(), mme_playlist_delete(), mme_playlist_hdl_t, mme_playlist_item_get(), mme_playlist_items_count_get(), mme_playlist_open(), mme_playlist_position_set(), mme_playlist_set_statement(), mme_playlist_sync()