mmrenderer_request_events()

#include <bps/mmrenderer.h>
 

BPS_API mmrenderer_monitor_t* mmrenderer_request_events(const char *ctxtname,
                                                        unsigned flags,
                                                        intptr_t userdata)

Since:

BlackBerry 10.0.0

Arguments:

ctxtname

The name of the multimedia renderer context to monitor.

flags

The types of events to deliver. A value of zero indicates that all events are requested. The meaning of non-zero values is reserved for future use.

userdata

A user data value. You can use this data to store any additional information that your application needs to interact with the multimedia renderer.

Library:

libbps (For the qcc command, use the -l bps option to link against this library)

Description:

The mmrenderer_request_events() function starts to deliver multimedia renderer events to your application using BPS. When you call this function, you must specify the name of a multimedia renderer context to monitor. This context must have been created previously, either by your application or by another application that allows the context to be shared.

Returns:

A handle for the specified context, or NULL if an error occurred.