mmplaylist_props_get()

Get properties of a playlist session

Synopsis:

#include <mm/mmplaylist.h>
mmplaylist_props_t* mmplaylist_props_get( mmplaylist_t *pl )

Arguments:

pl
A valid session handle.

Library:

libmmplaylist

Description:

This function gets the properties of a playlist session. The properties are written in a data structure returned to the caller. Applications can then read the properties to learn which operations are fast in the current session and then provide a better user experience by avoiding slow operations.

The mmplaylist_props_get() function allocates memory for the structure that it returns. The caller should free this memory using free().

Returns:

A pointer to an mmplaylist_props_t structure
Success.
NULL
Failure (call mmplaylist_last_error_get() for details).