audio_manager_device_capabilities_t

The audio capabilities that can be queried.

Synopsis:

#include <audio/audio_manager_device.h>
 
typedef enum {
      AUDIO_DEVICE_PROPERTY_NUM_OUT_CHANNELS   
      AUDIO_DEVICE_PROPERTY_NUM_IN_CHANNELS   
      AUDIO_DEVICE_PROPERTY_CHANNEL_ORDER   
      AUDIO_DEVICE_PROPERTY_CHANNEL_CONFIG   
      AUDIO_DEVICE_PROPERTY_SUPPORTED   
      AUDIO_DEVICE_PROPERTY_CONNECTED   
      AUDIO_DEVICE_PROPERTY_SUSPENDED   
      AUDIO_DEVICE_PROPERTY_VOLUME_CONTROL   
      AUDIO_DEVICE_PROPERTY_PUBLIC   
      AUDIO_DEVICE_PROPERTY_NUM_HW_IN_CHANNELS   
      AUDIO_DEVICE_PROPERTY_VOICE_CAPABILITIES   
      AUDIO_DEVICE_PROPERTY_COUNT   
} audio_manager_device_capabilities_t;

Since:

BlackBerry 10.0.0

Data:

AUDIO_DEVICE_PROPERTY_NUM_OUT_CHANNELS
The number of output channels that are supported, as an int value.
AUDIO_DEVICE_PROPERTY_NUM_IN_CHANNELS
The number of input channels that are supported, as an int value.
AUDIO_DEVICE_PROPERTY_CHANNEL_ORDER
The output channels that are listed in the order that the channel was setup up.

Each type is an audio_manager_channel_t[] array. This parameter is permitted only when AUDIO_DEVICE_PROPERTY_NUM_OUT_CHANNELS is requested as well. If the number of channels is greater than the input value for AUDIO_DEVICE_PROPERTY_NUM_OUT_CHANNELS then, at most, the input value is written.

AUDIO_DEVICE_PROPERTY_CHANNEL_CONFIG
An integer that represents the channel configuration of the audio device.

This integer is a combination of one or more bit masks of the type audio_manager_channel_config_t.

AUDIO_DEVICE_PROPERTY_SUPPORTED
Whether the device is supported on this platform, as a bool value.
AUDIO_DEVICE_PROPERTY_CONNECTED
Whether the device is currently connected, as a bool value.

For example, in the case of headphones, this property indicates whether the headphones are plugged in.

AUDIO_DEVICE_PROPERTY_SUSPENDED
Whether the device is suspended, as a bool value.
AUDIO_DEVICE_PROPERTY_VOLUME_CONTROL
The type of volume control supported by the device as an audio_manager_device_volume_control_t value.
AUDIO_DEVICE_PROPERTY_PUBLIC
Whether the device is public, as a bool value.

This property indicates whether the device is a public or private listening device. For example, a public listening device can be heard by multiple people, such as a loudspeaker as opposed to headphones, which are private listening devices.

AUDIO_DEVICE_PROPERTY_NUM_HW_IN_CHANNELS
The number of input channels supported by the device.

This enumerator represents the true number of input channels that a device supports and is different from AUDIO_DEVICE_PROPERTY_NUM_IN_CHANNELS.

AUDIO_DEVICE_PROPERTY_VOICE_CAPABILITIES
The bitmask of voice capabilities in the format of (1u<<audio_manager_voice_service_t) supported by the specified device as an int value.

Since: BlackBerry 10.2.0

AUDIO_DEVICE_PROPERTY_COUNT
The total number of device properties supported.

Library:

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

Description:

This enumeration defines the audio capabilities that can be queried.