SetVolume

概要: baSetVolumeはサウンドカードのWAVEファイルとオーディオCDの音量を設定します。

シンタックス: Result = baSetVolume( Device, Volume )

パラメータ: #string, #integer
Device 音量を変更するデバイス。以下のいずれかになります。
"master"  全体の音量を設定します
"wave"  WAVEとビデオファイルの音量を設定します
"cd"  オーディオCD再生の音量を設定します
"midi"  外部MIDIデバイスの音量を設定します
"synth"  内部FMシンセサイザの音量を設定します
"master mute"  全体のミュートを制御します
"wave mute"  WAVEのミュートを制御します
"cd mute"  CDのミュートを制御します
"synth mute"  内蔵シンセサイザのミュートを制御します

Volume 設定する音量。音量は0(無音)と100(最大レベル)の間で設定します。ミュートするデバイスに関しては、Volumeに1を指定するとミュートを有効に、0を指定するとミュートを無効にします。

戻り値:

#integer
成功した場合は1を、それ以外は0を返します。

例: OK = baSetVolume( "cd" , 50 )

ノート:

すべてのサウンドカードがこのファンクションをサポートしているわけではありません。サウンドカードによってはデバイスの一部のタイプのみをサポートしているものもあります。サポートしていない機能の場合は0を返します。

このファンクションは最初に見つかったサウンドカードに対する音量の設定をします。

全体のボリュームとミュートオプションについては、32bit環境でシステムにミキサーデバイスがインストールされている場合のみ利用可能です。

サウンドカードのなかには音量を正確に設定しないものがあります。例えば、音量を50に設定してもbaGetVolumeで調べると48や49を返すものがあります。

関連項目: baGetVolume