snd_pcm_plugin_info()

Получение информации о возможностях PCM канала (плагино-зависимая функция)

Прототип:

#include <sys/asoundlib.h>
                                       
int snd_pcm_plugin_info( snd_pcm_t *handle, 
                         snd_pcm_channel_info_t *info );

Аргументы:

handle: Дескриптор PCM устройства, созданный с помощью snd_pcm_open() или snd_pcm_open_preferred().
info: Указатель на заполняемую структуру snd_pcm_channel_info_t. Перед вызовом функции следует установить поле channel структуры для указания направления передачи данных в канале. Остальные поля заполняются функцией.

Описание:

Функция snd_pcm_plugin_info() заполняет структуру info информацией о выбранном PCM канале, определяемом дескриптором handle.

Данная функция и ее плагино-независимая версия snd_pcm_channel_info() получают динамический слепок текущих возможностей канала, которые могут с течением времени сужаться и расширяться по мере освобождения и выделения субканалов. Она схожа с snd_ctl_pcm_channel_info(), которая получает информацию о полном перечне возможностей канала.

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

EOK: Успешное завершение.
<0: Возникла ошибка, возвращенный код характеризует ошибку (также устанавливается errno).

Коды ошибок:

-EINVAL: Некорректный аргумент handle.

Примеры:

См. wave.c.

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

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

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

Предостережения:

Функция является плагино-зависимым аналогом snd_pcm_channel_info(). Следует убедиться, что плагино-зависимый и независимый вызовы не смешиваются в приложении. В противном случае поведение будет непредсказуемым.

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

snd_pcm_channel_info(), snd_pcm_channel_info_t

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