SoundGetName

サウンドデバイスやコンポーネントの名前を取得します。

Name := SoundGetName(Component, Device)

パラメータ

Component

型：文字列または整数

空白または省略したときは、デバイス名そのものを取得します。そうでないときは、1や"Line in"のようにコンポーネントの表示名とインデックスのいずれかを指定するか、"Line in:2"のようにその両方を指定します。

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

Device

型：文字列または整数

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

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

戻り値

型：文字列

この関数は、デバイス名またはコンポーネント名を返しますが、空のときもあります。

エラー処理

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

Sound関数

例

デフォルトの再生デバイス名を取得し、報告します。

default_device := SoundGetName()
MsgBox "The default playback device is " default_device

最初のデバイスの名前を取得し、報告します。

device1 := SoundGetName( , 1)
MsgBox "Device 1 is " device1

最初のコンポーネントの名前を取得して報告する。

component1 := SoundGetName(1)
MsgBox "Component 1 is " component1

より複雑な例については、>soundcard analysis scriptをご覧ください。