waveOutGetVolume

Declare Function Api_waveOutGetVolume& Lib "Winmm" Alias "waveOutGetVolume" (ByVal wDeviceID&, dwVolume&)

Declare Function waveOutGetVolume Lib "Winmm" (ByVal wDeviceID As Integer, dwVolume As Long) As Integer

指定されたウェーブフォームオーディオ出力デバイスの現在のボリュームレベルを取得する。

パラメータ
hwo
    オープンしているウェーブフォームオーディオ出力デバイスのハンドルを指定する。

    このパラメータには、デバイス識別子を指定することもできる。
pdwVolume
    現在のボリューム設定が入る変数のアドレスを指定する。

    この位置の下位ワードには、左チャネルのボリューム設定が入り、上位ワードには右チャネルのボリューム設定が入る。

    値が 0xFFFF の場合は最大ボリュームを表し、0x0000 の場合は無音を表す。
    デバイスが左右両方のボリュームコントロールをサポートしない場合、指定された位置の下位ワードにモノラルのボリュームレベルが入る。
    デバイスが全 16 ビットのボリュームレベルコントロールをサポートするかどうかにかかわらず、waveOutSetVolume 関数で設定された全 16

    ビットの設定が返る。

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

値	説明
MMSYSERR_INVALHANDLE	指定されたデバイスハンドルは無効。
MMSYSERR_NODRIVER	デバイスドライバが存在しない。
MMSYSERR_NOMEM	メモリを割り当てられないか、またはロックできない。
MMSYSERR_NOTSUPPORTED	関数がサポートされていない。