mirrors/alsa-lib
1
0
Fork 0
mirror of https://github.com/alsa-project/alsa-lib.git synced 2026-02-26 01:40:07 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

control: improve snd_ctl_add_*_elem_set functions (access flags)

Browse source 
The access flags are useful for the user space elements
with the custom access flags.

Introduce snd_ctl_elem_info_set_*() functions to set those flags
in the info structure.

Signed-off-by: Jaroslav Kysela <perex@perex.cz>
This commit is contained in:
Jaroslav Kysela 2021-02-22 12:24:58 +01:00
parent 7da208173f
commit 174592280d
2 changed files with 84 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

3
include/control.h
View file

@ -545,6 +545,9 @@ void snd_ctl_elem_info_set_device(snd_ctl_elem_info_t *obj, unsigned int val);
void snd_ctl_elem_info_set_subdevice(snd_ctl_elem_info_t *obj, unsigned int val); void snd_ctl_elem_info_set_subdevice(snd_ctl_elem_info_t *obj, unsigned int val);
void snd_ctl_elem_info_set_name(snd_ctl_elem_info_t *obj, const char *val); void snd_ctl_elem_info_set_name(snd_ctl_elem_info_t *obj, const char *val);
void snd_ctl_elem_info_set_index(snd_ctl_elem_info_t *obj, unsigned int val); void snd_ctl_elem_info_set_index(snd_ctl_elem_info_t *obj, unsigned int val);
void snd_ctl_elem_info_set_read_write(snd_ctl_elem_info_t *obj, int rval, int wval);
void snd_ctl_elem_info_set_tlv_read_write(snd_ctl_elem_info_t *obj, int rval, int wval);
void snd_ctl_elem_info_set_inactive(snd_ctl_elem_info_t *obj, int val);
int snd_ctl_add_integer_elem_set(snd_ctl_t *ctl, snd_ctl_elem_info_t *info, int snd_ctl_add_integer_elem_set(snd_ctl_t *ctl, snd_ctl_elem_info_t *info,
unsigned int element_count, unsigned int element_count,

96
src/control/control.c
View file

@ -409,6 +409,32 @@ static bool validate_element_member_dimension(snd_ctl_elem_info_t *info)
#define validate_element_member_dimension(info) true #define validate_element_member_dimension(info) true
#endif /* deprecated */ #endif /* deprecated */
#define USER_ACCESS_DEFAULT (\
SNDRV_CTL_ELEM_ACCESS_READWRITE |\
SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE |\
SNDRV_CTL_ELEM_ACCESS_USER)
#define USER_ACCESS_SETTABLE (\
SNDRV_CTL_ELEM_ACCESS_READWRITE |\
SNDRV_CTL_ELEM_ACCESS_VOLATILE |\
SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE |\
SNDRV_CTL_ELEM_ACCESS_INACTIVE |\
SNDRV_CTL_ELEM_ACCESS_USER)
static inline int set_user_access(snd_ctl_elem_info_t *info)
{
if (info->access == 0) {
info->access = USER_ACCESS_DEFAULT;
} else {
if ((info->access & SNDRV_CTL_ELEM_ACCESS_READWRITE) == 0)
return -1;
if (info->access & ~USER_ACCESS_SETTABLE)
return -1;
info->access |= SNDRV_CTL_ELEM_ACCESS_USER;
}
return 0;
}
/** /**
* \brief Create and add some user-defined control elements of integer type. * \brief Create and add some user-defined control elements of integer type.
* \param ctl A handle of backend module for control interface. * \param ctl A handle of backend module for control interface.
@ -465,10 +491,10 @@ int snd_ctl_add_integer_elem_set(snd_ctl_t *ctl, snd_ctl_elem_info_t *info,
if (ctl == NULL || info == NULL || info->id.name[0] == '\0') if (ctl == NULL || info == NULL || info->id.name[0] == '\0')
return -EINVAL; return -EINVAL;
if (set_user_access(info))
return -EINVAL;
info->type = SND_CTL_ELEM_TYPE_INTEGER; info->type = SND_CTL_ELEM_TYPE_INTEGER;
info->access = SNDRV_CTL_ELEM_ACCESS_READWRITE |
SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE |
SNDRV_CTL_ELEM_ACCESS_USER;
info->owner = element_count; info->owner = element_count;
info->count = member_count; info->count = member_count;
info->value.integer.min = min; info->value.integer.min = min;
@ -555,10 +581,10 @@ int snd_ctl_add_integer64_elem_set(snd_ctl_t *ctl, snd_ctl_elem_info_t *info,
if (ctl == NULL || info == NULL || info->id.name[0] == '\0') if (ctl == NULL || info == NULL || info->id.name[0] == '\0')
return -EINVAL; return -EINVAL;
if (set_user_access(info))
return -EINVAL;
info->type = SND_CTL_ELEM_TYPE_INTEGER64; info->type = SND_CTL_ELEM_TYPE_INTEGER64;
info->access = SNDRV_CTL_ELEM_ACCESS_READWRITE |
SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE |
SNDRV_CTL_ELEM_ACCESS_USER;
info->owner = element_count; info->owner = element_count;
info->count = member_count; info->count = member_count;
info->value.integer64.min = min; info->value.integer64.min = min;
@ -634,10 +660,10 @@ int snd_ctl_add_boolean_elem_set(snd_ctl_t *ctl, snd_ctl_elem_info_t *info,
if (ctl == NULL || info == NULL || info->id.name[0] == '\0') if (ctl == NULL || info == NULL || info->id.name[0] == '\0')
return -EINVAL; return -EINVAL;
if (set_user_access(info))
return -EINVAL;
info->type = SND_CTL_ELEM_TYPE_BOOLEAN; info->type = SND_CTL_ELEM_TYPE_BOOLEAN;
info->access = SNDRV_CTL_ELEM_ACCESS_READWRITE |
SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE |
SNDRV_CTL_ELEM_ACCESS_USER;
info->owner = element_count; info->owner = element_count;
info->count = member_count; info->count = member_count;
info->value.integer.min = 0; info->value.integer.min = 0;
@ -706,10 +732,10 @@ int snd_ctl_add_enumerated_elem_set(snd_ctl_t *ctl, snd_ctl_elem_info_t *info,
labels == NULL) labels == NULL)
return -EINVAL; return -EINVAL;
if (set_user_access(info))
return -EINVAL;
info->type = SND_CTL_ELEM_TYPE_ENUMERATED; info->type = SND_CTL_ELEM_TYPE_ENUMERATED;
info->access = SNDRV_CTL_ELEM_ACCESS_READWRITE |
SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE |
SNDRV_CTL_ELEM_ACCESS_USER;
info->owner = element_count; info->owner = element_count;
info->count = member_count; info->count = member_count;
info->value.enumerated.items = items; info->value.enumerated.items = items;
@ -786,10 +812,10 @@ int snd_ctl_add_bytes_elem_set(snd_ctl_t *ctl, snd_ctl_elem_info_t *info,
if (ctl == NULL || info == NULL || info->id.name[0] == '\0') if (ctl == NULL || info == NULL || info->id.name[0] == '\0')
return -EINVAL; return -EINVAL;
if (set_user_access(info))
return -EINVAL;
info->type = SND_CTL_ELEM_TYPE_BYTES; info->type = SND_CTL_ELEM_TYPE_BYTES;
info->access = SNDRV_CTL_ELEM_ACCESS_READWRITE |
SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE |
SNDRV_CTL_ELEM_ACCESS_USER;
info->owner = element_count; info->owner = element_count;
info->count = member_count; info->count = member_count;
@ -2890,6 +2916,46 @@ void snd_ctl_elem_info_set_index(snd_ctl_elem_info_t *obj, unsigned int val)
obj->id.index = val; obj->id.index = val;
} }
/**
* \brief Set readability/writeability parameter of a CTL element id/info
* \param obj CTL element id/info
* \param rval readability part of element identifier
* \param wval writeability part of element identifier
*/
void snd_ctl_elem_info_set_read_write(snd_ctl_elem_info_t *obj, int rval, int wval)
{
assert(obj);
obj->access = (obj->access & ~SNDRV_CTL_ELEM_ACCESS_READWRITE) |
(rval ? SNDRV_CTL_ELEM_ACCESS_READ : 0) |
(wval ? SNDRV_CTL_ELEM_ACCESS_WRITE : 0);
}
/**
* \brief Set TLV readability/writeability parameter of a CTL element id/info
* \param obj CTL element id/info
* \param rval TLV readability part of element identifier
* \param wval TLV writeability part of element identifier
*/
void snd_ctl_elem_info_set_tlv_read_write(snd_ctl_elem_info_t *obj, int rval, int wval)
{
assert(obj);
obj->access = (obj->access & ~SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE) |
(rval ? SNDRV_CTL_ELEM_ACCESS_TLV_READ : 0) |
(wval ? SNDRV_CTL_ELEM_ACCESS_TLV_WRITE : 0);
}
/**
* \brief Set inactive parameter of a CTL element id/info
* \param obj CTL element id/info
* \param val inactive part of element identifier
*/
void snd_ctl_elem_info_set_inactive(snd_ctl_elem_info_t *obj, int val)
{
assert(obj);
obj->access = (obj->access & ~SNDRV_CTL_ELEM_ACCESS_INACTIVE) |
(val ? SNDRV_CTL_ELEM_ACCESS_INACTIVE : 0);
}
/** /**
* \brief Get size of data structure for an element. * \brief Get size of data structure for an element.
* \return Size in bytes. * \return Size in bytes.