mme_play_set_output_attr()

Set the attributes for an output device

Synopsis:

#include <mme/mme.h>

int mme_play_set_output_attr( mme_hdl_t *hdl,
                              uint64_t outputdeviceid,
                              mme_output_attr_t *attr );

Arguments:

hdl
An MME connection handle.
outputdeviceid
The ID of the output device on which to set attributes.
attr
A pointer to a structure with the output device attributes. See mme_output_attr_t in this reference.

Library:

mme

Description:

The function mme_play_set_output_attr() sets the output attributes for the specified output device. These attributes are carried in the data structure mme_output_attr_t described in this reference.

To apply the same attributes to all output devices attached to a control context, set outputdeviceid to 0. The MME will iterate through all attached output devices and apply the values specified in mme_output_attr_t to them.

Events

This function delivers MME_EVENT_OUTPUTATTRCHANGE with the ID of the output device where the change occured, in mme_event_data_t.value.

Blocking and validation

This function validates the output device ID, and behaves as follows, depending on whether the MME is currently playing a track:

Returns:

0
Success.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_play_get_output_attr(), mme_output_set_permanent()