audio_manager_get_handle()

#include <audio/audio_manager_routing.h>
 

int audio_manager_get_handle(audio_manager_audio_type_t type, pid_t caller_pid, bool start_suspended, unsigned int *audioman_handle)

Since:

BlackBerry 10.0.0

Arguments:

type

The type of audio type to query from the audio manager service.

caller_pid

The ID of the process that the audio manager handle is allocated for. The value of zero represents the current process ID.

start_suspended

Whether the handle is to be suspended after allocation. A value of true to suspend the audio source after allocation while a value of false indicates otherwise.

audioman_handle

The handle to the audio source that's allocated.

Library:

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

Description:

An audio manager handle is used to track each audio source. Use audio_manager_get_handle() to return a handle based on the audio type and a flag that indicates whether the handle is immediately activated.

Returns:

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