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)。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |
| ヘッダー |
|
関連項目