mme_explore_playlist_find_file()

Convert playlist file entries to filenames

Synopsis:

#include <mme/explore.h>

const mme_explore_info_t *mme_explore_playlist_find_file( mme_hdl_t *hdl,
                                                          uint64_t msid,
                                                          const char *entry,
                                                          const char *path,
                                                          const char *metadata_types,
                                                          uint32_t flags );

Arguments:

hdl
A handle to the MME returned by mme_explore_start().
msid
The ID of the media store to explore.
entry
The playlist file entry retrieved from the explorer.
path
The path of the playlist file on the mediastore.
metadata_types
An optional pointer to a string containing a comma-separated list of metadata types to retrieve. This pointer may be NULL. See METADATA_* in this reference.
flags
For future use.

Library:

mme

Description:

The function mme_explore_playlist_find_file() converts playlist file entries retrieved during exploration of a playlist file or folder to a filename on the system, and returns information about these converted entries in a mme_explore_info_t structure.


Note:
  • You should convert your playlists to UTF-8 before calling mme_explore_playlist_find_file(). This function currently assumes that the entry argument is in UTF-8 character encoding. Characters in playlists may not be in UTF-8 encoding, and if they are not converted to UTF-8 may cause the function to fail.
  • Since mme_explore_playlist_find_file() cannot know the origin of entries it converts, it always returns a value of 0 for the index member of the returned mme_explore_info_t structure.

Events

None delivered.

Blocking and validation

This function performs no validations. It doesn't block.

Returns:

A populated mme_explore_info_t structure on success, or NULL if an error occurred (errno is set).

The result of a successful call to mme_explore_playlist_find_file() must be released by mme_explore_info_free().

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_explore_end(), mme_explore_hdl_t, mme_explore_info_free(), mme_explore_info_get(), mme_explore_info_t, mme_explore_position_set(), mme_explore_size_get(), mme_explore_start()