mme_explore_info_get()

Get information about an item being explored

Synopsis:

#include <mme/explore.h>

const mme_explore_info_t *mme_explore_info_get( mme_explore_hdl_t *x_hdl,
                                                uint32_t flags);

Arguments:

x_hdl
An explorer handle returned by mme_explore_start().
flags
Flags describing the type of item.

Library:

mme

Description:

The function mme_explore_info_get() retrieves information about an item in a folder or a playlist file, and returns this information in the data structure mme_explore_info_t. This information is:

The path information is identical in format to the path information returned by mme_ms_metadata_get(), and used by mme_play_file() (deprecated).

The item the information is for is determined by:

Each time this function is called, the offset position is incremented by 1 (one), until either mme_explore_end() or mme_explore_position_set() is called. If no offset position is set, mme_explore_info_get() starts retrieving information from the first item in the folder.


Note: Items retrieved by mme_explore_info_get() are presented as they occur; that is, they are not sorted or reorganized in any way.

MME_EXPLORE_RESOLVE_PLAYLIST_ITEM

The constant MME_EXPLORE_RESOLVE_PLAYLIST_ITEM is an inbound flag telling the MME to resolve playlist file entries immediately. Using this flag results in much faster resolution of playlist contents to playable files, but the actual playlist entry value is not visible at to the client application.

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_t, mme_explore_playlist_find_file(), mme_explore_position_set(), mme_explore_size_get(), mme_explore_start()