GetVolume
|
概要: |
baGetVolumeはWAVEファイルとオーディオCDの現在の音量を取得します。
|
シンタックス: |
Result = baGetVolume( Device )
|
パラメータ: |
#string, #integer
Device 音量を取得するデバイス。以下のいずれかになります。
"master" |
全体の音量を取得します |
"wave" |
WAVEとビデオファイルの音量を取得します |
"cd" |
オーディオCD再生の音量を取得します |
"midi" |
外部MIDIデバイスの音量を取得します |
"synth" |
内部FMシンセサイザの音量を取得します |
"master mute" |
全体のミュートの状態を取得します |
"wave mute" |
WAVEのミュートの状態を取得します |
"cd mute" |
CDのミュートの状態を取得します |
"synth mute" |
内蔵シンセサイザのミュートの状態を取得します |
|
戻り値: |
#integer
指定したデバイスの音量を返します。音量は0(無音)と100(最大レベル)の間になります。ミュートオプションに関しては、ミュートが有効の場合は1を、無効の場合は0を返します。
ファンクションがサポートされていない場合は-1を返します。
|
例: |
Volume = baGetVolume( "wave" )
|
ノート: |
すべてのサウンドカードがこのファンクションをサポートしているわけではありません。サウンドカードによってはデバイスの一部のタイプのみをサポートしているものもあります。サポートしていない機能の場合は-1を返します。
このファンクションは最初に見つかったサウンドカードの音量を取得します。
全体のボリュームとミュートオプションについては、32bit環境でシステムにミキサーデバイスがインストールされている場合のみ利用可能です。
左右のチャンネルで異なるレベルが設定されていた場合は、2つの平均値を返します。
サウンドカードのなかには音量を正確に設定しないものがあります。例えばbaSetVolumeを使って音量を50に設定しても、当ファンクションで調べると48や49を返すものがあります。
|
関連項目: |
baSetVolume |