snd_pcm_get_audioman_handle()

Retrieve an audioman handle that's bound to a PCM stream

Synopsis:

#include <sys/asoundlib.h>

int snd_pcm_get_audioman_handle( snd_pcm_t *handle,
                                 unsigned int *audioman_handle );

Arguments:

handle
The handle for the PCM device, which you must have opened by calling snd_pcm_open_name(), snd_pcm_open(), or snd_pcm_open_preferred().
audioman_handle
A pointer to a location where the function can store the handle of the audio manager.

Library:

libasound.so

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

Description:

The snd_pcm_get_audioman_handle() function retrieves an audioman handle that's bound to a PCM stream. Binding an audioman handle to a PCM stream results in the PCM stream's conditionally ducking behind other streams, depending on the type of other stream playing.

Returns:

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

Errors:

-EINVAL
The PCM handle is NULL, or the value of the audio handle passed to the function was SND_PCM_AUDIOMAN_NO_HANDLE.

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 handle(snd_pcm_t) is used across multiple threads.