SoundGetVolume

サウンドデバイスの音量設定を取得します。

Setting := SoundGetVolume(Component, Device)

パラメータ

コンポーネント

型:文字列または整数

If blank or omitted, it defaults to the master volume setting. Otherwise, specify the component's display name and/or index, e.g. 1, "Line in" or "Line in:2".

詳しくは「コンポーネント(サウンド機能)」をご覧ください。

Device

型:文字列または整数

If blank or omitted, it defaults to the system's default device for playback (which is not necessarily device 1). Otherwise, specify the device's display name and/or index, e.g. 1, "Speakers", "Speakers:2" or "Speakers (Example HD Audio)".

詳しくはデバイス(サウンド機能)をご覧ください。

戻り値

型:浮動小数点数

この関数は、0.0 から 100.0 までの浮動小数点数を返します。

エラー処理

A TargetError is thrown if the device or component could not be found or if the component does not support this control type. Otherwise, an OSError is thrown on failure.

備考

システムにインストールされているサウンドデバイスの機能(名前や使用可能なコンポーネントなど)を調べるには、サウンドカード解析スクリプトを実行します。

サウンド機能

マスターボリュームを取得し、報告する。

master_volume := SoundGetVolume()
MsgBox "Master volume is " master_volume " percent."

マイクのリスニング音量を取得し、報告する。

mic_volume := SoundGetVolume("Microphone")
MsgBox "Microphone listening volume is " mic_volume " percent."

マイクの録音音量を取得し、報告する。

mic_volume := SoundGetVolume( , "Microphone")
MsgBox "Microphone recording volume is " mic_volume " percent."