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 を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。
| リターン コード | 説明 |
|---|---|
|
パラメーター nChannel は、ストリーム内のチャネルの数以上です。 |
|
パラメーター pfLevelDB が NULL です。 |
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | endpointvolume.h |