auxSetVolume

auxSetVolume 関数は指定された補助出力デバイスの音量を設定する。

auxSetVolume uDeviceID, dwVolume

uDeviceID : [int] 問い合わせ対象の補助出力デバイスの識別子。デバイス識別子はシステムに存在するデバイスの数から暗黙的に決定される。デバイス識別子の値は 0 から存在するデバイスの数より 1 少ない値までの範囲となる。システム内の補助デバイスの数を判定するには auxGetNumDevs 関数を使用する。
dwVolume : [int] 新しい音量設定を指定する。下位ワードに左チャネルの音量設定を、上位ワードに右チャネルの設定を指定する。0xFFFF が最大音量、0x0000 が無音を表す。デバイスが左右両チャネルの音量制御をサポートしていない場合、dwVolume の下位ワードで音量レベルを指定し、上位ワードは無視される。

(プラグイン / モジュール : winmm.dll)

解説

auxSetVolume 関数は指定された補助出力デバイスの音量を設定する。

[戻り値]
成功時は MMSYSERR_NOERROR を、それ以外の場合はエラーを返す。考えられるエラー値は次のとおり。
（以下省略）

[備考]
全てのデバイスが音量制御をサポートしているわけではない。デバイスが音量制御をサポートしているかを判定するには、AUXCAPS_VOLUME
フラグを用いて (auxGetDevCaps 関数で取得した) AUXCAPS 構造体の dwSupport
メンバをテストする。デバイスが左右両チャネルの音量制御をサポートしているかを判定するには、AUXCAPS_LRVOLUME フラグを用いて
AUXCAPS 構造体の dwSupport メンバをテストする。ほとんどのデバイスは 16
ビット全ての音量レベル制御をサポートしておらず、要求された音量設定の上位ビットのみを使用する。例えば 4
ビットの音量制御をサポートするデバイスでは、要求音量レベル値 0x4000、0x4FFF、0x43BE は同じ物理音量設定 0x4000
を生成する。auxGetVolume 関数は auxSetVolume で設定された完全な 16
ビット値を返す。音量設定は対数的に解釈される。これは音量レベルを 0x5000 から 0x6000 に上げたときと 0x4000 から
0x5000 に上げたときの音量増加が同じように知覚されることを意味する。

情報