auxGetVolume 関数 (mmeapi.h)

  • [アーティクル]

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

構文

MMRESULT auxGetVolume(
  UINT    uDeviceID,
  LPDWORD pdwVolume
);

パラメーター

uDeviceID

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

pdwVolume

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

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

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

戻り値

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

リターン コード 説明
MMSYSERR_BADDEVICEID
 指定されたデバイス識別子が範囲外です。

注釈

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

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

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mmeapi.h (Windows.h を含む)
Library Winmm.lib
[DLL] Winmm.dll

こちらもご覧ください

波形オーディオ

波形関数