ALSA Library Reference Manual
NANE
snd_mixer_group_write - Mixerインターフェースのグループに関するデータを書き込む関数
SYNOPSIS
DESCRIPTION
snd_mixer_group_write関数は*groupの内容をMixerインターフェースのgroup->gidの示すグループに書き込む。
Mixerグループに関する情報を書き込むには、あらかじめsnd_mixer_group_read関数でこのグループに関する情報を取得しておくべきである。この情報を元に変更箇所を更新し、snd_mixer_write関数で書き込む。
- unsigned int group->mute
- このMixerグループでミュートしたいチャネルのビットをセットする。
- unsigned int group->capture
- このMixerグループで録音したいチャネルのビットをセットする。ただし、このMixerグループに録音機能がある必要がある。
各チャネルの音量はgroup->volume.values[N]で指定する。Nは0から31の範囲で、group->cnanelsで示されたビットの番号のものが有効になる。各チャネルの名称はsnd_mixer_channel_name関数で取得可能である。
上のチャネルの中で、しばしば使用される代表的なチャネルについては以下のgroup->volume.namesに用意されている。
- int group->volume.names.front_left
- 左の音量
- int group->volume.names.front_right
- 右の音量
- int group->volume.names.front_center
- 中央の音量
- int group->volume.names.rear_left
- 後ろ(rear)の左の音量
- int group->volume.names.rear_right
- 後ろ(rear)の右の音量
- int group->volume.names.woofer
- ウーハーの音量
RETURN VALUES
snd_mixer_group_write関数は成功すれば0を返し、そうでなければエラーコードを返す。
ERRORS
- -EINVAL
- snd_mixer_group_writeで与えられたhandleまたはgroupはNULLである。
SEE ALSO