次の方法で共有


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
パラメーター pfLevelDBNULL です

要件

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

関連項目

IAudioEndpointVolume インターフェイス

IAudioEndpointVolume::GetChannelCount

IAudioEndpointVolume::GetVolumeRange