mme_explore_start()

Start exploring an item on a mediastore

Synopsis:

#include <mme/explore.h>

mme_explore_hdl_t *mme_explore_start( mme_hdl_t *hdl,
                                      uint64_t uint64_t msid,
                                      const char *path,
                                      uint32_t flags );

Arguments:

hdl
An MME connection handle.
msid
The ID of the media store to explore.
path
The path to the item to explore. Use an empty string to start at the root of the media store. See the “Description” below.
flags
For future use.

Library:

mme

Description:

The function mme_explore_start() returns a handle to be used to explore a mediastore. After calling mme_explore_start(), you can use other mme_explore_*() functions to find and learn about folders and files of interest on the media store.


Note:

The path argument can be refer to a file marked as a playlist as well as to a folder or to a file that can be played.


Events

None delivered.

Blocking and validation

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

Returns:

An initialized mme_explore_hdl_t, or NULL if an error occurred (errno is set).

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_playlist_find_file(), mme_explore_position_set(), mme_explore_size_get()