snd_pcm_plugin_set_best_fit

Synopsis:

#include <sys/asoundlib.h>

int snd_pcm_plugin_set_best_fit_voices(snd_pcm_t       *pcm, 
                                       int              angle,
                                       snd_pcm_chmap_t *chmap)

Since:

BlackBerry 10.3.0

Arguments:

pcm: The handle returned by a call to a snd_pcm_open_* function.
angle: The clockwise orientation of the device, in degrees. For example, specify 90 when the top of the device is physically to the right.
chmap: A map of the microphone and speaker positions that you want for each data channel.

Library:

libasound.so

Use the -l asound option to qcc and link against this library.

Description:

Configure the best microphone or speakers to fit a set of requested microphones and speakers when the device is rotated at a specified angle. The result of calling this function is one of the following:

If the hardware supports the selection of the best channel for voice, the hardware is configured as closely as possible to the request.
if the hardware doesn't support it, the voice matrix is configured

Note: Whether a voice matrix or hardware is configured, the actual resulting configuration may deviate slightly to the requested configuration.

Returns:

EOK upon success, a negative errno upon failure. The errno values are available in the errno.h file.

Classification:

QNX Neutrino

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Read the Caveats

Caveats:

This function is not thread safe if pcm (snd_pcm_t) is used across multiple threads.

snd_pcm_plugin_set_best_fit_voices()