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

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

構文

HRESULT GetChannelVolume(
  [in]  UINT32 dwIndex,
  [out] float  *pfLevel
);

[in] dwIndex

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

[out] pfLevel

メソッドが指定したチャネルのボリュームレベルを書き込む float 変数へのポインター。ボリュームレベルの範囲は 0.0 から 1.0 です。

メソッドが成功した場合は、S_OK を返します。失敗した場合、次の表に示す値が含まれますが、これに限定されません。

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

クライアントは、IAudioStreamVolume::SetAllVolumes メソッドまたは IAudioStreamVolume::SetChannelVolume メソッドを呼び出して、オーディオストリーム内のチャネルごとのボリュームレベルを設定できます。