ado_mixer_element_route_add()

Indicate an ordered relationship between two mixer elements

Synopsis:

#include <audio_driver.h>

int32_t ado_mixer_element_route_add
  ( ado_mixer_t *mixer,
    ado_mixer_delement_t *elem_before,
    ado_mixer_delement_t *elem );

Arguments:

mixer
A pointer to the ado_mixer_t structure for the mixer that the elements belong to.
elem_before
A pointer to the ado_mixer_delement_t structure for the mixer element that's the input to elem.
elem
A pointer to the ado_mixer_delement_t structure for the mixer element that gets its input from elem_before.

Description:

This function establishes an ordered relationship between two elements of the given mixer. The output from elem_before becomes the input to elem. When you use it repeatedly, this function builds route tables showing the relationships between all mixer elements.

Returns:

-1 if an error occurred (errno is set). Any other value indicates success.

Errors:

ENOMEM
Not enough free memory to extend the elements' route tables.

Classification:

QNX Neutrino

Safety:
Cancellation point No
Interrupt handler No
Signal handler No
Thread No