→ AutoHotkeyを流行らせるページ → リファレンス → SoundGet

SoundGet

サウンドデバイスの各種設定を取得

SoundGet, OutputVar [, ComponentType, ControlType, DeviceNumber]

Parameters

引数名説明
OutputVar 取得した値を格納する変数名。
ComponentType 以下のどれか。
  • MASTER(デフォルト)
  • DIGITAL
  • LINE
  • MICROPHONE
  • SYNTH
  • CD
  • TELEPHONE
  • PCSPEAKER
  • WAVE
  • AUX
  • ANALOG
  • HEADPHONES
  • N/A
デバイスが存在しない場合、ErrorLevelにその旨を示す文字列が代入される。
同じ種類のものが複数あるときは「ANALOG:2」のように指定することで、2つ目以降のデバイスを指定できる。多くの場合、1番目が出力、2番目が入力用デバイスである。
ControlType
  • VOLUME(デフォルト)
  • ONOFF
  • MUTE
  • MONO
  • LOUDNESS
  • STEREOENH
  • BASSBOOST
  • PAN
  • QSOUNDPAN
  • BASS
  • TREBLE
  • EQUALIZER
その設定が存在しない場合、ErrorLevelにその旨を示す文字列が代入される。
番号で指定することもできる。
DeviceNumber デバイス番号。
デフォルトは「1」

ErrorLevel

成功した場合、「0」。
何か問題があれば、以下のような文が代入される。

Remarks

OutputVarには、ControlTypeが「ONOFF」「MUTE」「MONO」「LOUDNESS」「STEREOENH」「BASSBOOST」の場合「ON」か「OFF」、それ以外の場合は0...100の小数が代入される。
小数のフォーマットはSetFormatで設定できる。
取得に失敗したら空になる。

ComponentTypeやControlTypeに指定可能な値を調査する方法は、SoundSetのExamplesを参照。

Related

SoundSet, SoundGetWaveVolume, SoundSetWaveVolume, SoundPlay

Example(s)

SoundGet, master_volume
MsgBox, Master volume is %master_volume% percent.

SoundGet, master_mute, , mute
MsgBox, Master Mute is currently %master_mute%.

SoundGet, bass_level, Master, bass
if ErrorLevel <> 0
	MsgBox, Error Description: %ErrorLevel%
else
	MsgBox, The BASS level for MASTER is %bass_level% percent.

SoundGet, microphone_mute, Microphone, mute
if microphone_mute = Off
	MsgBox, The microphone is not muted.
→ AutoHotkeyを流行らせるページ → リファレンス → SoundGet