mirror of
https://github.com/openharmony/third_party_tinyalsa.git
synced 2026-07-19 23:33:30 -04:00
Richard Fitzgerald
fd3290357e
New controls could appear during runtime, for example if a new firmware is downloaded to a DSP. Since ALSA drivers are not supposed to delete or renumber existing controls we can assume that any new controls will be after any controls we already know about. We can use this to enable extending our current list of controls, which is more efficient than closing the mixer session and recreating it. Signed-off-by: Richard Fitzgerald <rf@opensource.wolfsonmicro.com>
136 lines
4.6 KiB
C
136 lines
4.6 KiB
C
/* mixer.h
|
|
**
|
|
** Copyright 2011, The Android Open Source Project
|
|
**
|
|
** Redistribution and use in source and binary forms, with or without
|
|
** modification, are permitted provided that the following conditions are met:
|
|
** * Redistributions of source code must retain the above copyright
|
|
** notice, this list of conditions and the following disclaimer.
|
|
** * Redistributions in binary form must reproduce the above copyright
|
|
** notice, this list of conditions and the following disclaimer in the
|
|
** documentation and/or other materials provided with the distribution.
|
|
** * Neither the name of The Android Open Source Project nor the names of
|
|
** its contributors may be used to endorse or promote products derived
|
|
** from this software without specific prior written permission.
|
|
**
|
|
** THIS SOFTWARE IS PROVIDED BY The Android Open Source Project ``AS IS'' AND
|
|
** ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
** IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
** ARE DISCLAIMED. IN NO EVENT SHALL The Android Open Source Project BE LIABLE
|
|
** FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
** DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
** SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
** CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
** LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
** OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
|
|
** DAMAGE.
|
|
*/
|
|
|
|
/** @file */
|
|
|
|
/** @defgroup libtinyalsa-mixer Mixer Interface
|
|
* @brief All macros, structures and functions that make up the mixer interface.
|
|
*/
|
|
|
|
#ifndef TINYALSA_MIXER_H
|
|
#define TINYALSA_MIXER_H
|
|
|
|
#include <stddef.h>
|
|
|
|
#if defined(__cplusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct mixer;
|
|
|
|
struct mixer_ctl;
|
|
|
|
/** Mixer control type.
|
|
* @ingroup libtinyalsa-mixer
|
|
*/
|
|
enum mixer_ctl_type {
|
|
/** boolean control type */
|
|
MIXER_CTL_TYPE_BOOL,
|
|
/** integer control type */
|
|
MIXER_CTL_TYPE_INT,
|
|
/** an enumerated control type */
|
|
MIXER_CTL_TYPE_ENUM,
|
|
MIXER_CTL_TYPE_BYTE,
|
|
MIXER_CTL_TYPE_IEC958,
|
|
/** a 64 bit integer control type */
|
|
MIXER_CTL_TYPE_INT64,
|
|
/** unknown control type */
|
|
MIXER_CTL_TYPE_UNKNOWN,
|
|
/** end of the enumeration (not a control type) */
|
|
MIXER_CTL_TYPE_MAX,
|
|
};
|
|
|
|
struct mixer *mixer_open(unsigned int card);
|
|
|
|
void mixer_close(struct mixer *mixer);
|
|
|
|
int mixer_add_new_ctls(struct mixer *mixer);
|
|
|
|
const char *mixer_get_name(const struct mixer *mixer);
|
|
|
|
unsigned int mixer_get_num_ctls(const struct mixer *mixer);
|
|
|
|
unsigned int mixer_get_num_ctls_by_name(const struct mixer *mixer, const char *name);
|
|
|
|
const struct mixer_ctl *mixer_get_ctl_const(const struct mixer *mixer, unsigned int id);
|
|
|
|
struct mixer_ctl *mixer_get_ctl(struct mixer *mixer, unsigned int id);
|
|
|
|
struct mixer_ctl *mixer_get_ctl_by_name(struct mixer *mixer, const char *name);
|
|
|
|
struct mixer_ctl *mixer_get_ctl_by_name_and_index(struct mixer *mixer,
|
|
const char *name,
|
|
unsigned int index);
|
|
|
|
unsigned int mixer_ctl_get_id(const struct mixer_ctl *ctl);
|
|
|
|
const char *mixer_ctl_get_name(const struct mixer_ctl *ctl);
|
|
|
|
enum mixer_ctl_type mixer_ctl_get_type(const struct mixer_ctl *ctl);
|
|
|
|
const char *mixer_ctl_get_type_string(const struct mixer_ctl *ctl);
|
|
|
|
unsigned int mixer_ctl_get_num_values(const struct mixer_ctl *ctl);
|
|
|
|
unsigned int mixer_ctl_get_num_enums(const struct mixer_ctl *ctl);
|
|
|
|
const char *mixer_ctl_get_enum_string(struct mixer_ctl *ctl, unsigned int enum_id);
|
|
|
|
/* Some sound cards update their controls due to external events,
|
|
* such as HDMI EDID byte data changing when an HDMI cable is
|
|
* connected. This API allows the count of elements to be updated.
|
|
*/
|
|
void mixer_ctl_update(struct mixer_ctl *ctl);
|
|
|
|
/* Set and get mixer controls */
|
|
int mixer_ctl_get_percent(const struct mixer_ctl *ctl, unsigned int id);
|
|
|
|
int mixer_ctl_set_percent(struct mixer_ctl *ctl, unsigned int id, int percent);
|
|
|
|
int mixer_ctl_get_value(const struct mixer_ctl *ctl, unsigned int id);
|
|
|
|
int mixer_ctl_get_array(const struct mixer_ctl *ctl, void *array, size_t count);
|
|
|
|
int mixer_ctl_set_value(struct mixer_ctl *ctl, unsigned int id, int value);
|
|
|
|
int mixer_ctl_set_array(struct mixer_ctl *ctl, const void *array, size_t count);
|
|
|
|
int mixer_ctl_set_enum_by_string(struct mixer_ctl *ctl, const char *string);
|
|
|
|
/* Determe range of integer mixer controls */
|
|
int mixer_ctl_get_range_min(const struct mixer_ctl *ctl);
|
|
|
|
int mixer_ctl_get_range_max(const struct mixer_ctl *ctl);
|
|
|
|
#if defined(__cplusplus)
|
|
} /* extern "C" */
|
|
#endif
|
|
|
|
#endif
|
|
|