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

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

構文

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

[in] dwIndex

チャネル番号。オーディオセッションのストリーム形式に N 個のチャネルがある場合、チャネルには 0 から N – 1 の番号が付きます。チャネルの数を取得するには、 IChannelAudioVolume::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 オーディオサービスが実行されていません。

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