ALSA: Add helper function to add single value constraint
authorLars-Peter Clausen <lars@metafoo.de>
Sun, 18 Oct 2015 13:39:16 +0000 (15:39 +0200)
committerTakashi Iwai <tiwai@suse.de>
Wed, 21 Oct 2015 12:24:14 +0000 (14:24 +0200)
commitbc1043cdcd84cb441d80cfd79ae4325218f6f9ba
tree3f7415ac850fc01cbf07fd0c3ad53860201306d7
parent7379047d5585187d1288486d4627873170d0005a
ALSA: Add helper function to add single value constraint

The recommended and most efficient way to constraint a configuration
parameter to a single value is to set the minimum and maximum allowed
values to the same value, i.e. calling snd_pcm_hw_constraint_minmax() with
the same value for min and max.

It is not necessarily obvious though that this is the approach that should
be taken and some drivers have come up with other ways of solving this
problem, e.g. installing a list constraint with a single item. List
constraints are dynamic constraints though and hence less efficient than
the static min-max constraint.

This patch introduces a new helper function called
snd_pcm_hw_constraint_single() which only takes a single value has the same
effect as calling snd_pcm_hw_constraint_minmax() with the same values for
min and max. But it is hopefully semantically more expressive, making it
clear that this is the preferred way of setting a single value constraint.

Signed-off-by: Lars-Peter Clausen <lars@metafoo.de>
Acked-by: Mark Brown <broonie@kernel.org>
Signed-off-by: Takashi Iwai <tiwai@suse.de>
include/sound/pcm.h