snd_mixer_groups()

Получение числа групп микшера и их идентификаторов

Прототип:

#include <sys/asoundlib.h>
                                       
int snd_mixer_groups( snd_mixer_t *handle, 
                      snd_mixer_groups_t *groups );

Аргументы:

handle: Дескриптор устройства микшера, созданный с помощью snd_mixer_open().
groups: Указатель на структуру snd_mixer_groups_t для заполнения.

Функция snd_mixer_groups() заполняет переданную структуру snd_mixer_groups_t числом групп в микшере с дескриптором handle. Также заполняется массив идентификаторов групп, на который указывает поле pgroups размером groups_size.

Перед вызовом snd_mixer_groups() следует устаноить следующие поля структуры snd_mixer_groups_t:

pgroups: NULL или указатель на хранилище информации о группах (например, на массив структур snd_mixer_gid_t).
groups_size: Размер хранилища pgroups в единицах sizeof( snd_mixer_gid_t ) (например, число записей в массиве).

При успешном выполнении snd_mixer_groups() заполняет следующие поля структуры:

groups: Общее число групп в микшере.
groups_over: Число групп, информация о которых не могла быть скопирована в хранилище pgroups из-за ограничений по размеру.

Возвращаемое значение:

0: Успешное завершение.
-EINVAL: Некорректный аргумент handle.

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования
Точка остановки потока: Нет
Обработчик прерываний: Нет
Обработчик сигналов: Да
В потоке: Да

Тематические ссылки:

snd_mixer_gid_t, snd_mixer_group_read(), snd_mixer_group_write(), snd_mixer_groups_t, snd_mixer_sort_gid_table()

Предыдущий раздел: Библиотека libasound