snd_mixer_elements()

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

Прототип:

#include <sys/asoundlib.h>
                                       
int snd_mixer_elements( snd_mixer_t *handle, 
                        snd_mixer_elements_t *elements );

Аргументы:

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

Функция snd_mixer_elements() заполняет переданную структуру snd_mixer_elements_t числом элементов в микшере, который идентифицируется параметром handle. Также функция заполняет массив идентификаторов элементов pelements размером elements_size (см. описание структуры snd_mixer_elements_t).

Настоятельно рекомендуется взаимодействовать с группой элементов, а не каждым элементом напрямую.

Перед вызовом snd_mixer_elements() следует проинициализировать структуру snd_mixer_elements_t следующим образом:

pelements: NULL или указатель на корректное хранилище для элементов (например, массив стркутур snd_mixer_eid_t).
elements_size: Соответствует размеры хранилища pelements в единицах sizeof( snd_mixer_eid_t ) (например, elements_size должен быть равен числу элементов в массиве pelements).

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

elements: Общее число элементов в микшере.
pelements: Если не равно NULL, массив заполняется идентификаторами элементов микшера.
elements_over: Число элементов, информация о которых не была записана в хранилище pelements.

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

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

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

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

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

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

snd_mixer_eid_t, snd_mixer_element_read(), snd_mixer_element_write(), snd_mixer_elements_t, snd_mixer_sort_eid_table()

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