IAudioStreamVolume::SetChannelVolume メソッド (audioclient.h)

SetChannelVolume メソッドは、オーディオストリーム内の指定されたチャネルのボリュームレベルを設定します。

構文

HRESULT SetChannelVolume(
  [in] UINT32      dwIndex,
  [in] const float fLevel
);

[in] dwIndex

チャネル番号。ストリーム形式に N 個のチャネルがある場合、チャネルには 0 から N – 1 の番号が付きます。チャネルの数を取得するには、 IAudioStreamVolume::GetChannelCount メソッドを呼び出します。

[in] fLevel

チャネルのボリュームレベル。有効なボリューム・レベルの範囲は 0.0 から 1.0 です。

メソッドが成功した場合は、S_OK を返します。エラーが発生した場合、次の表に示す値が、可能なリターンコードに含まれますが、これらに限定されません。

リターンコード	説明
E_INVALIDARG	パラメーター dwIndex が無効なチャネル番号に設定されているか、パラメーター fLevel が 0.0 から 1.0 の範囲ではありません。
AUDCLNT_E_DEVICE_INVALIDATED	オーディオエンドポイントデバイスが取り外されているか、オーディオハードウェアまたは関連するハードウェアリソースが再構成、無効、削除、またはその他の方法で使用できなくなります。
AUDCLNT_E_SERVICE_NOT_RUNNING	Windows オーディオサービスが実行されていません。