Ξ
Δ
◄
►
¬
Ѕ
フィルター
ディレクティブ
組み込みの変数
組み込み関数
制御フロー文
演算子
宣言
組み込みクラス
組み込みメソッド／プロパティ
Ahk2Exeコンパイラ
キーワードをハイライト
</head> <body> <h1>SoundGetName</h1> <p>サウンドデバイスやコンポーネントの名前を取得します。</p> <pre class="Syntax">Name := <span class="func">SoundGetName</span>(<span class="optional">Component, Device</span>)</pre> <h2 id="Parameters">パラメータ</h2> <dl> <dt>Component</dt> <dd> <p>型：<a href="../Concepts.htm#strings">文字列</a>または<a href="../Concepts.htm#numbers">整数</a></p> <p>空白または省略したときは、デバイス名そのものを取得します。そうでないときは、<code>1</code>や<code>"Line in"</code>のようにコンポーネントの表示名とインデックスのいずれかを指定するか、<code>"Line in:2"</code>のようにその両方を指定します。</p> <p>詳しくは「<a href="Sound.htm#component">Component（Sound関数）</a>」をご覧ください。</p> </dd> <dt>Device</dt> <dd> <p>型：<a href="../Concepts.htm#strings">文字列</a>または<a href="../Concepts.htm#numbers">整数</a></p> <p>空白または省略したときは、初期値はシステムのデフォルトの再生デバイス（必ずしもデバイス1である必要はありません）になります。そうでないときは、<code>1</code>や<code>"Speakers"</code>や<code>"Speakers (Example HD Audio)"</code>のようにコンポーネントの表示名とインデックスのいずれかを指定するか、<code>"Speakers:2"</code>のようにその両方を指定します。</p> <p>詳しくは<a href="Sound.htm#device">Device（Sound関数）</a>をご覧ください。</p> </dd> </dl> <h2 id="Return_Value">戻り値</h2> <p>型：<a href="../Concepts.htm#strings">文字列</a></p> <p>この関数は、デバイス名またはコンポーネント名を返しますが、空のときもあります。</p> <h2 id="Error_Handling">エラー処理</h2> <p>デバイスまたはコンポーネントが見つからないときは、<a href="Error.htm#TargetError">TargetError</a>がスローされます。そうでないときは、失敗したときに<a href="Error.htm#OSError">OSError</a>がスローされます。</p> <h2 id="Related">関連</h2> <p><a href="Sound.htm">Sound関数</a></p> <h2 id="Examples">例</h2> <div class="ex" id="ExNoParams"> <p><a class="ex_number" href="#ExNoParams"></a> デフォルトの再生デバイス名を取得し、報告します。</p> <pre>default_device := SoundGetName() MsgBox "The default playback device is " default_device</pre> </div> <div class="ex" id="ExDevice"> <p><a class="ex_number" href="#ExDevice"></a> 最初のデバイスの名前を取得し、報告します。</p> <pre>device1 := SoundGetName( , 1) MsgBox "Device 1 is " device1</pre> </div> <div class="ex" id="ExComponent"> <p><a class="ex_number" href="#ExComponent"></a> 最初のコンポーネントの名前を取得して報告する。</p> <pre>component1 := SoundGetName(1) MsgBox "Component 1 is " component1</pre> </div> <p>より複雑な例については、<a href="Sound.htm#ExSoundcard">>soundcard analysis script</a>をご覧ください。</p> </body> </html>