auxSetVolume 関数 (mmeapi.h)

  • [アーティクル]

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

構文

MMRESULT auxSetVolume(
  UINT  uDeviceID,
  DWORD dwVolume
);

パラメーター

uDeviceID

照会する補助出力装置の ID。 デバイス識別子は、システムに存在するデバイスの数から暗黙的に決定されます。 デバイス識別子の値は、存在するデバイスの数より 0 から 1 未満の範囲です。 auxGetNumDevs 関数を使用して、システム内の補助デバイスの数を確認します。

dwVolume

新しいボリューム設定を指定します。 下位ワードは左チャネル・ボリューム設定を指定し、高位ワードは右チャネル設定を指定します。 0xFFFFの値はボリューム全体を表し、0x0000の値は無音です。

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

戻り値

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

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

注釈

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

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

ほとんどのデバイスは、ボリューム レベル制御の完全な 16 ビットをサポートしていないため、要求されたボリューム設定の上位ビットのみを使用します。 たとえば、4 ビットのボリューム制御をサポートするデバイスの場合、0x4000、0x4FFF、0x43BEの要求されたボリューム レベル値は、同じ物理ボリューム設定 (0x4000) を生成します。 auxGetVolume 関数は、auxSetVolume で設定された完全な 16 ビット設定を返します。

ボリューム設定は対数的に解釈されます。 つまり、ボリューム レベルを0x5000から0x6000に増やすと、0x4000から0x5000に増加する場合と同じになります。

要件

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

こちらもご覧ください

波形オーディオ

波形関数