auxGetVolume

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

auxGetVolume uDeviceID, pdwVolume

uDeviceID : [int] 問い合わせ対象の補助出力デバイスの識別子。
pdwVolume : [var] 現在の音量設定が格納される変数へのポインタ。下位ワードに左チャネルの音量設定が、上位ワードに右チャネルの設定が格納される。0xFFFF が最大音量、0x0000 が無音を表す。デバイスが左右両チャネルの音量制御をサポートしていない場合、指定された場所の下位ワードに音量レベルが格納される。auxSetVolume 関数で設定した完全な 16 ビットの値が、デバイスが 16 ビット全ての音量制御をサポートしているかどうかにかかわらず返される。

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

解説

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

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

[備考]
全てのデバイスが音量制御をサポートしているわけではない。デバイスが音量制御をサポートしているかを判定するには、AUXCAPS_VOLUME
フラグを用いて (auxGetDevCaps 関数で取得した) AUXCAPS 構造体の dwSupport
メンバをテストする。デバイスが左右両チャネルの音量制御をサポートしているかを判定するには、AUXCAPS_LRVOLUME フラグを用いて
AUXCAPS 構造体の dwSupport メンバをテストする。

情報