IAudioEndpointVolume インターフェイス (endpointvolume.h)

[アーティクル]
03/14/2023

IAudioEndpointVolume インターフェイスは、オーディオエンドポイントデバイス間のオーディオストリーム上のボリュームコントロールを表します。クライアントは、パラメーター iid が REFIID IID_IAudioEndpointVolumeに設定された IMMDevice::Activate メソッドを呼び出すことによって、エンドポイントデバイスの IAudioEndpointVolume インターフェイスへの参照を取得します。

MMDevice API と WASAPI を使用するオーディオアプリケーションでは、通常、ISimpleAudioVolume インターフェイスを使用して、セッションごとにストリームボリュームレベルを管理します。まれに、特殊なオーディオアプリケーションでは、オーディオエンドポイントデバイスのマスターボリュームレベルを制御するために IAudioEndpointVolume インターフェイスの使用が必要になる場合があります。 IAudioEndpointVolume のクライアントは、オーディオエンドポイントデバイスのマスターボリュームレベルを変更する他のオーディオアプリケーションに破壊的影響が及ぶ可能性を回避するために注意する必要があります。通常、ユーザーは Windows ボリューム制御プログラム (Sndvol.exe) を使用してマスターボリュームレベルを排他的に制御できます。

エンドポイントデバイスとの間でオーディオデータをストリーミングするアダプターデバイスにハードウェアボリュームとミュートコントロールがある場合、 IAudioEndpointVolume インターフェイスはこれらのコントロールを使用してオーディオストリームのボリュームとミュート設定を管理します。オーディオデバイスにストリームのハードウェアボリュームコントロールがない場合、オーディオエンジンは自動的にソフトウェアにボリュームコントロールとミュートコントロールを実装します。

エンドポイントデバイスとの間で共有モードストリームを管理するアプリケーションの場合、 IAudioEndpointVolume の動作は、ストリームのレンダリングとストリームのキャプチャに対して異なります。

共有モードレンダリングストリームの場合、クライアントが IAudioEndpointVolume インターフェイスを介してアクセスするエンドポイントボリュームコントロールは、 ISimpleAudioVolume インターフェイスと IChannelAudioVolume インターフェイスが実装するセッションごとのボリュームコントロールとは独立して動作します。したがって、レンダリングストリームのボリュームレベルは、エンドポイントボリュームコントロールとセッションごとのコントロールの組み合わせの効果から生じます。

共有モードキャプチャストリームの場合、 ISimpleAudioVolume インターフェイスと IChannelAudioVolume インターフェイスが実装するセッションごとのボリュームコントロールは、 IAudioEndpointVolume インターフェイスによって実装されるエンドポイントボリュームコントロールに直接関連付けられます。 ISimpleAudioVolume インターフェイスと IChannelAudioVolume インターフェイスのメソッドを使用してセッションごとのボリュームコントロールを変更すると、IAudioEndpointVolume インターフェイスのボリュームコントロールの設定が変更され、逆も true になります。各インターフェイスで表されるボリュームレベルは、次のように相互に対応します。

ストリーム内の各チャネルについて、 IAudioEndpointVolume は、0.0 (最小ボリューム) から 1.0 (最大ボリューム) の範囲の正規化された値にマップされる、デシベル (dB) で表されるオーディオテーパボリュームレベルを提供します。指定できる範囲は、オーディオドライバーによって異なります。詳細については、「 IAudioEndpointVolume::GetVolumeRange 」を参照してください。
ISimpleAudioVolume::GetMasterVolume によって表されるセッションボリュームは、0.0 から 1.0 までのスカラー値で、さまざまなチャネルの最大ボリューム設定に対応します。たとえば、左側のチャネルが 0.8 に設定されていて、右側のチャネルが 0.4 に設定されている場合、 ISimpleAudioVolume::GetMasterVolume は 0.8 を返します。
チャネルごとのボリュームレベルが IChannelAudioVolume インターフェイスのメソッドを使用して制御されている場合、ボリュームを示すスカラーは常にセッションボリュームに対して相対的です。つまり、ボリュームが最も大きいチャネルのボリュームは 1.0 です。 IAudioEndpointVolume::SetChannelVolumeLevelScalar によって 0.8 と 0.4 のボリュームに設定された 2 つのチャネルの例を考えると、IChannelAudioVolume::GetChannelVolume は 1.0 と 0.5 のボリュームを示します。

メモEndpointVolume API のクライアントは、今後のリリースで変更される可能性があるため、上記の動作に依存しないでください。

デバイスにハードウェアボリュームとミュートコントロールがある場合、 IAudioEndpointVolume インターフェイスを介してデバイスのボリュームとミュート設定に加えられた変更は、共有モードと排他モードの両方のボリュームレベルに影響します。デバイスにハードウェアボリュームとミュートコントロールがない場合、 IAudioEndpointVolume インターフェイスを介してソフトウェアボリュームとミュートコントロールに加えられた変更は、共有モードではボリュームレベルに影響しますが、排他モードでは影響しません。排他モードでは、クライアントとデバイスはオーディオデータを直接交換し、ソフトウェアコントロールをバイパスします。ただし、ソフトウェアコントロールは永続的であり、デバイスが排他モードで動作している間に行われたボリュームの変更は、デバイスが共有モード操作に切り替わるときに有効になります。

デバイスにハードウェアボリュームとミュートコントロールがあるかどうかを確認するには、 IAudioEndpointVolume::QueryHardwareSupport メソッドを呼び出します。

IAudioEndpointVolume インターフェイスのメソッドを使用すると、クライアントはボリュームレベルをデシベル単位で、または正規化されたオーディオテーパ値として表現できます。後者の場合、ボリュームレベルは、0.0 (最小ボリューム) から 1.0 (最大ボリューム) までの正規化された範囲の浮動小数点値として表されます。この範囲内では、正規化されたボリュームレベルと信号振幅の減衰の関係が、非線形のオーディオテーパ曲線によって記述されます。オーディオテーパカーブの詳細については、「 Audio-Tapered Volume Controls」を参照してください。

さらに、ユーザーインターフェイスでボリュームスライダーを便利にサポートするために、 IAudioEndpointVolume インターフェイスを使用すると、クライアントは個別の値または "ステップ" として表されるボリュームレベルを設定および取得できます。このステップは、非線形のオーディオテーパ曲線上に均一に分散されます。範囲に n 個のステップが含まれている場合、ステップには 0 から n – 1 の番号が付けられます。ここで、ステップ 0 は最小ボリュームレベルを表し、ステップ n – 1 は最大値を表します。

IAudioEndpointVolume インターフェイスを使用するコード例については、「Endpoint Volume Controls」を参照してください。

継承

IAudioEndpointVolume インターフェイスは、IUnknown インターフェイスから継承されます。 IAudioEndpointVolume には、次の種類のメンバーもあります。

メソッド

IAudioEndpointVolume インターフェイスには、これらのメソッドがあります。


IAudioEndpointVolume::GetChannelCount GetChannelCount メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリーム内のチャネルの数を取得します。
IAudioEndpointVolume::GetChannelVolumeLevel GetChannelVolumeLevel メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリーム内の指定されたチャネルのボリュームレベルをデシベル単位で取得します。
IAudioEndpointVolume::GetChannelVolumeLevelScalar GetChannelVolumeLevelScalar メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリームの指定されたチャネルの、正規化されたオーディオテーパボリュームレベルを取得します。
IAudioEndpointVolume::GetMasterVolumeLevel GetMasterVolumeLevel メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリームのマスターボリュームレベルをデシベル単位で取得します。
IAudioEndpointVolume::GetMasterVolumeLevelScalar GetMasterVolumeLevelScalar メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリームのマスターボリュームレベルを取得します。ボリュームレベルは、0.0 から 1.0 の範囲の正規化されたオーディオテーパ値として表されます。
IAudioEndpointVolume::GetMute GetMute メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリームのミュート状態を取得します。
IAudioEndpointVolume::GetVolumeRange GetVolumeRange メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリームのボリューム範囲をデシベル単位で取得します。
IAudioEndpointVolume::GetVolumeStepInfo GetVolumeStepInfo メソッドは、ボリューム範囲内の現在のステップに関する情報を取得します。
IAudioEndpointVolume::QueryHardwareSupport QueryHardwareSupport メソッドは、ハードウェアでサポートされている関数についてオーディオエンドポイントデバイスに対してクエリを実行します。 (IAudioEndpointVolume.QueryHardwareSupport)
IAudioEndpointVolume::RegisterControlChangeNotify RegisterControlChangeNotify メソッドは、クライアントの通知コールバックインターフェイスを登録します。
IAudioEndpointVolume::SetChannelVolumeLevel SetChannelVolumeLevel メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリームの指定されたチャネルのボリュームレベルをデシベル単位で設定します。
IAudioEndpointVolume::SetChannelVolumeLevelScalar SetChannelVolumeLevelScalar メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリーム内の指定されたチャネルの、正規化されたオーディオテーパボリュームレベルを設定します。
IAudioEndpointVolume::SetMasterVolumeLevel SetMasterVolumeLevel メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリームのマスターボリュームレベルをデシベル単位で設定します。
IAudioEndpointVolume::SetMasterVolumeLevelScalar SetMasterVolumeLevelScalar メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリームのマスターボリュームレベルを設定します。ボリュームレベルは、0.0 から 1.0 の範囲の正規化されたオーディオテーパ値として表されます。
IAudioEndpointVolume::SetMute SetMute メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリームのミュート状態を設定します。
IAudioEndpointVolume::UnregisterControlChangeNotify UnregisterControlChangeNotify メソッドは、クライアントが IAudioEndpointVolume::RegisterControlChangeNotify メソッドの以前の呼び出しで登録したクライアントの通知コールバックインターフェイスの登録を削除します。
IAudioEndpointVolume::VolumeStepDown VolumeStepDown メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリームのボリュームレベルを 1 ステップでデクリメントします。
IAudioEndpointVolume::VolumeStepUp VolumeStepUp メソッドは、オーディオエンドポイントデバイスに出入りするオーディオストリームのボリュームレベルを 1 ステップずつインクリメントします。

要件


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

IAudioEndpointVolume インターフェイス (endpointvolume.h)

継承

メソッド

要件

関連項目

フィードバック

フィードバック

その他のリソース