IAudioEndpointVolume::GetChannelVolumeLevel メソッド (endpointvolume.h)

GetChannelVolumeLevel メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリーム内の指定されたチャネルのボリュームレベルをデシベル単位で取得します。

構文

HRESULT GetChannelVolumeLevel(
  [in]  UINT  nChannel,
  [out] float *pfLevelDB
);

[in] nChannel

チャネル番号。オーディオストリームに n 個のチャネルがある場合、チャネルには 0 ~ n – 1 の番号が付きます。ストリーム内のチャネルの数を取得するには、 IAudioEndpointVolume::GetChannelCount メソッドを呼び出します。

[out] pfLevelDB

メソッドがボリュームレベルをデシベルで書き込む float 変数へのポインター。このメソッドから取得したボリュームレベルの範囲を取得するには、 IAudioEndpointVolume::GetVolumeRange メソッドを呼び出します。

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

リターンコード	説明
E_INVALIDARG	パラメーター nChannel は、ストリーム内のチャネルの数以上です。
E_POINTER	パラメーター pfLevelDB が NULL です。


サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	endpointvolume.h