auxGetVolume 関数 (mmeapi.h)

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

構文

MMRESULT auxGetVolume(
  UINT    uDeviceID,
  LPDWORD pdwVolume
);

パラメーター

uDeviceID

照会する補助出力装置の ID。

pdwVolume

現在のボリューム設定で塗りつぶされる変数へのポインター。 この場所の下位ワードには左側のチャネル ボリューム設定が含まれており、上位ワードには右チャネル設定が含まれています。 0xFFFFの値はボリューム全体を表し、0x0000の値は無音です。

デバイスが左右のボリューム制御の両方をサポートしていない場合は、指定した場所の下位ワードにボリューム レベルが含まれます。

auxSetVolume 関数で設定された完全な 16 ビット設定は、デバイスがボリューム レベル制御の完全な 16 ビットをサポートしているかどうかに関係なく返されます。

戻り値

成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

注釈

すべてのデバイスがボリューム制御をサポートしているわけではありません。 デバイスがボリューム制御をサポートしているかどうかを判断するには、AUXCAPS_VOLUME フラグを使用して、AUXCAPS 構造体の dwSupport メンバーをテストします (auxGetDevCaps 関数によって入力されます)。

デバイスが左右のチャネルの両方でボリューム制御をサポートしているかどうかを判断するには、AUXCAPS_LRVOLUME フラグを使用して、AUXCAPS 構造体の dwSupport メンバーをテストします (auxGetDevCaps で塗りつぶされます)。

要件

こちらもご覧ください

波形オーディオ

波形関数