mme_play_attach_output()

Attach an output to a zone

Synopsis:

#include <mme/mme.h>

int mme_play_attach_output( mme_hdl_t *hdl,
                            uint64_t zoneid,
                            uint64_t outputid );

Arguments:

hdl
An MME connection handle.
zoneid
The zone to which you want to attach the output device. If set to 0, use the current control context zone.
outputid
The ID of the output device to attach to the zone.

Library:

mme

Description:

The function mme_play_attach_output() attaches an output device to a specified zone. Playback on the control context using the specified zone will go to the output devices attached to that zone.

The MME saves the output device setting so that the next time the control context is used it will automatically send its output to the same output devices.

Events

None delivered.

Blocking and validation

This function blocks on control contexts. It validates parameters. In asynchronous mode, it returns before calling io-media.

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_output_set_permanent(), mme_play_detach_output(), mme_play_get_zone(), mme_play_set_zone(), mme_zone_create(), mme_zone_delete().