snd_pcm_channel_prepare()

Информирование драйвера о необходимости подготовиться к операциям в канале

Прототип:

#include <sys/asoundlib.h>
                                       
int snd_pcm_channel_prepare( snd_pcm_t *handle, 
                             int channel );

Аргументы:

handle

Дескриптор PCM устройства, созданный с помощью snd_pcm_open() или snd_pcm_open_preferred().

channel

Канал:

SND_PCM_CHANNEL_CAPTURE
SND_PCM_CHANNEL_PLAYBACK

Функция snd_pcm_channel_prepare() подготваливает оборудование к выполнению операций захвата или воспроизведения аудио данных, вызывая snd_pcm_capture_prepare() или snd_pcm_playback_prepare(), в зависимости от значения параметра channel. Вызов отвечает за осуществление той части последовательности запуска оборудования, которая требует дополнительного времени на инициализацию.

Функция может быть вызвана из любого состояния драйвера, кроме SND_PCM_STATUS_NOTREADY (возвращается -EBADFD) и SND_PCM_STATUS_RUNNING (возвращается -EBUSY). Если операция завершается успешно (возвращается 0), состояние драйвера меняется на SND_PCM_STATUS_PREPARED.

Если в канале наблюдается переполнение (overrun при захвате) или недостаточность данных (underrun при воспроизведении), перед продолжением следует выполнить его подготовку (см. wave.c и waverec.c).

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

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

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

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

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

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

snd_pcm_capture_prepare(), snd_pcm_playback_prepare(), snd_pcm_plugin_prepare()

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