diff options
| -rw-r--r-- | include/tinyalsa/pcm.h | 4 | ||||
| -rw-r--r-- | src/pcm.c | 30 |
2 files changed, 34 insertions, 0 deletions
diff --git a/include/tinyalsa/pcm.h b/include/tinyalsa/pcm.h index 9157b9b..b7c32b3 100644 --- a/include/tinyalsa/pcm.h +++ b/include/tinyalsa/pcm.h @@ -236,6 +236,10 @@ struct pcm *pcm_open(unsigned int card, unsigned int flags, const struct pcm_config *config); +struct pcm *pcm_open_by_name(const char *name, + unsigned int flags, + const struct pcm_config *config); + int pcm_close(struct pcm *pcm); int pcm_is_ready(const struct pcm *pcm); @@ -859,6 +859,36 @@ int pcm_close(struct pcm *pcm) return 0; } +/** Opens a PCM by it's name. + * @param name The name of the PCM. + * The name is given in the format: <i>hw</i>:<b>card</b>,<b>device</b> + * @param flags Specify characteristics and functionality about the pcm. + * May be a bitwise AND of the following: + * - @ref PCM_IN + * - @ref PCM_OUT + * - @ref PCM_MMAP + * - @ref PCM_NOIRQ + * - @ref PCM_MONOTONIC + * @param config The hardware and software parameters to open the PCM with. + * @returns On success, returns an initialized pcm, ready for reading or writing. + * On error, returns NULL. + * @ingroup libtinyalsa-pcm + */ +struct pcm *pcm_open_by_name(const char *name, + unsigned int flags, + const struct pcm_config *config) +{ + unsigned int card, device; + if ((name[0] != 'h') + || (name[1] != 'w') + || (name[2] != ':')) { + return NULL; + } else if (sscanf(&name[3], "%u,%u", &card, &device) != 2) { + return NULL; + } + return pcm_open(card, device, flags, config); +} + /** Opens a PCM. * @param card The card that the pcm belongs to. * The default card is zero. |