![]() |
![]() |
![]() |
![]() |
Get information about an item being explored
#include <mme/explore.h> const mme_explore_info_t *mme_explore_info_get( mme_explore_hdl_t *x_hdl, uint32_t flags);
mme
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.
![]() |
Items retrieved by mme_explore_info_get() are presented as they occur; that is, they are not sorted or reorganized in any way. |
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.
None delivered.
This function performs no validations. It doesn't block.
An initialized mme_explore_hdl_t, or NULL if an error occurred (errno is set).
QNX Neutrino
Safety: | |
---|---|
Interrupt handler | No |
Signal handler | No |
Thread | Yes |
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()
![]() |
![]() |
![]() |
![]() |