mme_trksessionview_metadata_get()

Get metadata for a track in a track session

Synopsis:

#include <mme/mme.h>

mme_metadata_hdl_t *mme_trksessionview_metadata_get( mme_hdl_t *hdl,
                                                     unsigned track,
                                                     unsigned title,
                                                     unsigned chapter,
                                                     const char *types,
                                                     uint32_t flags );

Arguments:

hdl
The handle of the control context.
track
The number of the track for which you want information, counted sequentially from track 0 in the track session. (The track number is zero-based.)
title
The ID of the current title (track) in the device's track session.
chapter
For future use. The ID of the current chapter in the current title in the current track session on a DVD, or other mediastore or device.
types
The types of metadata requested. See the chapter Metadata and Artwork in the MME Developer's Guide.
flags
For future use.

Library:

mme

Description:

The function mme_trksessionview_metadata_get() retrieves metadata for a title or track on a DVD or a device, such as an iPod, that manages its own track sessions. It returns this metadata in the metadata structure mme_metadata_hdl_t.

Events

None delivered.

Blocking and validation

This function performs no validations, and doesn't block.

Returns:

0: data in mme_metadata_hdl_t.
Success.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_trksessionview_get_info(), mme_trksessionview_info_t, mme_trksessionview_readx(), mme_trksessionview_writedb()