MEAudioSessionVolumeChanged イベント

オーディオセッションのボリュームまたはミュート状態が変更されたときに、ストリーミングオーディオレンダラー (SAR) によって送信されます。

メディアセッションは、このイベントをアプリケーションに転送します。

イベント値

IMFMediaEvent::GetValue から取得できる値は次のとおりです。

VARTYPE	説明
VT_EMPTY	イベントデータはありません。
VT_UNKNOWN	IMFAudioPolicy インターフェイスへのポインター。

このイベントは、SAR のストリームシンクによって発生します。イベントは、SAR がオーディオセッションから IAudioSessionEvents::OnSimpleVolumeChanged イベントを受信したときにトリガーされます。新しいボリュームレベルとミュート状態を取得するには、 IMFSimpleAudioVolume::GetMasterVolume と IMFSimpleAudioVolume::GetMute を呼び出します。

SAR は、外部アクションによってボリュームが変更された場合 (たとえば、ユーザーがシステムボリューム制御プログラム (SndVol) を介してボリュームを変更した場合) に、このイベントを送信します。アプリケーションが SAR でボリュームを直接変更した場合、SAR はイベントを送信しません。

また、チャネルボリュームが変更されたときに SAR はこのイベントを送信しません (IAudioSessionEvents::OnChannelVolumeChanged)。