mmr_event_t

Information about an mm-renderer event

Synopsis:

#include <mm/renderer/events.h>
typedef struct mmr_event {
    mmr_event_type_t type;
    mmr_state_t state;
    int speed;
    union mmr_event::mmr_event_details details;
    const strm_string_t *pos_obj;
    const char *pos_str;
    const strm_dict_t *data;
    const char *objname;
    void *usrdata;
} mmr_event_t;

Data:

type
The event type.
state
The new context state (valid even when type is MMR_EVENT_NONE).
speed
The playback speed (0 means paused).
details
The event details (varies by type).
pos_obj
The playback position when the event occurred, stored as a shareable string, for STATUS, ERROR, and WARNING events; otherwise NULL.
pos_str
The playback position when the event occurred, stored as a string, for STATUS, ERROR, and WARNING events; otherwise NULL.
The position is expressed in the same media-specific format used by mmr_seek() (for single tracks, it's milliseconds; for playlists, it's tracknumber:milliseconds; for autolists, it's 1:milliseconds).
data
The full set of mm-renderer properties reported by the event, stored in a dictionary object. When this field is NULL, the set of properties no longer exists; for example, the input parameters, URL, and type are deleted when the input is detached.
objname
The name of the internal mm-renderer object associated with this event.
usrdata
The user data associated with the dictionary; NULL if there's no user data.

Library:

mmrndclient

Description:

The mmr_event_t structure is returned by mmr_event_get() and provides information on the last event. For all events, the structure contains the event type, the latest context state and playback speed, and if applicable, the playback position when the event occurred. For certain event types, there is additional information contained in the mmr_event::details and/or mmr_event::data fields.

Classification:

QNX Neutrino