auxGetVolume

Declare Function Api_auxGetVolume& Lib "winmm" Alias "auxGetVolume" (ByVal uDeviceID&, lpdwVolume&)

Declare Function auxGetVolume Lib "winmm" Alias "auxGetVolume" (ByVal uDeviceID As Long, lpdwVolume As Long) As Long

指定された補助出力デバイスの、現在のボリューム設定を取得する。

パラメータ

uDeviceID
    対象になる補助出力デバイスの識別子を指定する。
lpdwVolume
    ボリューム設定を受け取る変数のアドレスを指定する。下位ワードには左チャネルのボリューム設定が入り、上位ワードには右チャネルのボ

    リューム設定が入る。値が 0xFFFF の場合は最大ボリューム、0x0000 の場合は無音を表す。
    デバイスが左右両方のボリュームコントロールをサポートしていない場合、下位ワードにボリュームレベルが入る。
    全 16 ビットのボリュームレベルコントロールをサポートしているどうかを調べるには、auxSetVolume 関数を使う(「解説」参照)。

戻り値
    関数が成功すると MMSYSERR_NOERROR が返る。関数が失敗するとエラーが返る。返されるエラー値は次のとおりである。

値	説明
MMSYSERR_BADDEVICEID	指定されたデバイス識別子は範囲外のため無効である。

解説
    すべてのデバイスがボリュームコントロールをサポートしているとは限らない。サポートしているかどうかを調べるには、

    AUXCAPS_VOLUME フラグを使って、auxGetDevCaps 関数で提供される AUXCAPS 構造体の dwSupport メンバをテストする。
    デバイスが左右両方のチャネルのボリュームコントロールをサポートするかどうかを調べるには、AUXCAPS_LRVOLUME フラグを使って、

    auxGetDevCaps 関数で提供される AUXCAPS 構造体の dwSupport メンバをテストする。