IAudioSessionEvents::OnSimpleVolumeChanged メソッド (audiopolicy.h)

OnSimpleVolumeChanged メソッドは、オーディオ セッションのボリューム レベルまたはミュート状態が変更されたことをクライアントに通知します。

構文

HRESULT OnSimpleVolumeChanged(
  [in] float   NewVolume,
  [in] BOOL    NewMute,
  [in] LPCGUID EventContext
);

パラメーター

[in] NewVolume

オーディオ セッションの新しいボリューム レベル。 このパラメーターは、0.0 ~ 1.0 の範囲の値です。0.0 は無音で、1.0 は完全ボリューム (減衰なし) です。

[in] NewMute

新しいミュート状態。 TRUE の場合、ミュートが有効になります。 FALSE の場合、ミュートは無効になります。

[in] EventContext

イベント コンテキスト値。 これは、呼び出し元がセッションのボリューム レベルまたはミュート状態を変更した呼び出しで ISimpleAudioVolume::SetMasterVolume または ISimpleAudioVolume::SetMute に渡した値と同じです。 詳細については、「解説」を参照してください。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合はエラー コードを返します。

解説

セッション マネージャーは、 ISimpleAudioVolume::SetMasterVolume メソッドまたは ISimpleAudioVolume::SetMute メソッドの呼び出しによってセッションのボリューム レベルまたはミュート状態が変更されるたびに、このメソッドを呼び出します。

EventContext パラメーターは、クライアントが開始したボリュームまたはミュートの変更と、他のクライアントが開始した変更を区別するための手段を提供します。 ISimpleAudioVolume::SetMasterVolume メソッドまたは ISimpleAudioVolume::SetMute メソッドを呼び出すと、クライアントは、OnSimpleVolumeChanged メソッドの実装で認識できる EventContext パラメーター値を渡します。

IAudioSessionEvents インターフェイスに メソッドを実装するコード例については、「オーディオ セッション イベント」を参照してください。

要件

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

こちらもご覧ください

IAudioSessionEvents インターフェイス

ISimpleAudioVolume::SetMasterVolume

ISimpleAudioVolume::SetMute