SoundGetMute

サウンドデバイスのミュート設定を取得します。

Setting := SoundGetMute(Component, Device)

パラメータ

Component

型：文字列または整数

空白または省略したときは、デフォルトでマスターミュート設定になります。そうでないときは、1や"Line in"のようにコンポーネントの表示名とインデックスのいずれかを指定するか、"Line in:2"のようにその両方を指定します。

詳しくは「Component（Sound関数）」をご覧ください。

Device

型：文字列または整数

空白または省略したときは、初期値はシステムのデフォルトの再生デバイス（必ずしもデバイス1である必要はありません）になります。そうでないときは、1や"Speakers"や"Speakers (Example HD Audio)"のようにコンポーネントの表示名とインデックスのいずれかを指定するか、"Speakers:2"のようにその両方を指定します。

詳しくはDevice（Sound関数）をご覧ください。

戻り値

型：整数（ブーリアン）

この関数は、ミュートされていないときに0 (false)を、ミュートされているときに1 (true)を返します。

エラー処理

デバイスまたはコンポーネントが見つからないときや、コンポーネントがコントロールをサポートしていないときは、TargetErrorがスローされます。そうでないときは、失敗したときにOSErrorがスローされます。

備考

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

関連

Sound関数

例

master_mute := SoundGetMute()
if master_mute
    MsgBox "The default playback device is muted."
else
    MsgBox "The default playback device is not muted."

if SoundGetMute("Line In") = 0
    MsgBox "Line In pass-through is not muted."

if SoundGetMute( , "Microphone") = 0
    MsgBox "The microphone (recording) is not muted."