audio_manager_snd_pcm_open_preferred()

Open a preferred PCM channel with the specified audio type.

Synopsis:

#include <audio/audio_manager_routing.h>

int audio_manager_snd_pcm_open_preferred(audio_manager_audio_type_t type, snd_pcm_t **handle, unsigned int *audioman_handle, int *rcard, int *rdevice, int mode)

Since:

BlackBerry 10.0.0

Arguments:

type: The audio type of the PCM channel being allocated.

handle: The handle of the PCM channel opened.

audioman_handle: The audio manager handle allocated to the PCM channel.

rcard: The audio card used to open the PCM channel.

rdevice: The audio device used to open the PCM channel.

mode: The PCM channel mode defined in the asoundlib.h file.

Library:

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

Description:

The audio_manager_snd_pcm_open_preferred() function combines the snd_pcm_open_preferred() and audio_manager_get_handle() functions and allows the allocation of a specific audio type PCM channel in one step.

Returns:

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