IAudioSessionEvents インターフェイス (audiopolicy.h)

  • [アーティクル]

IAudioSessionEvents インターフェイスは、ボリューム レベルの変更、表示名、セッション状態などのセッション関連のイベントの通知を提供します。 WASAPI システム コンポーネントによって実装されるこのセクションの他のインターフェイスとは異なり、WASAPI クライアントは IAudioSessionEvents インターフェイスを実装します。 イベント通知を受信するために、クライアントは IAudioSessionEvents インターフェイスへのポインターを IAudioSessionControl::RegisterAudioSessionNotification メソッドに 渡します。

IAudioClientSessionEvents インターフェイスを登録すると、クライアントは インターフェイスの メソッドを介してコールバックの形式でイベント通知を受け取ります。

IAudioSessionEvents インターフェイスを実装する場合、クライアントはデッドロックと未定義の動作を回避するために、次の規則を遵守する必要があります。

  • インターフェイス内のメソッドは非ブロッキングである必要があります。 クライアントは、イベント コールバック中に同期オブジェクトを待機しないでください。
  • クライアントは、イベント コールバック中に IAudioSessionControl::UnregisterAudioSessionNotification メソッドを呼び出さないでください。
  • クライアントは、イベント コールバック中に WASAPI オブジェクトの最後の参照を解放しないでください。
IAudioSessionEvents インターフェイスを実装するコード例については、「オーディオ セッション イベント」を参照してください。 クライアントの IAudioSessionEvents インターフェイスを登録して通知を受信するコード例については、「 レガシ オーディオ アプリケーションのオーディオ イベント」を参照してください。

継承

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

メソッド

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

 
IAudioSessionEvents::OnChannelVolumeChanged

OnChannelVolumeChanged メソッドは、セッション サブミックス内のオーディオ チャネルのボリューム レベルが変更されたことをクライアントに通知します。
IAudioSessionEvents::OnDisplayNameChanged

OnDisplayNameChanged メソッドは、セッションの表示名が変更されたことをクライアントに通知します。
IAudioSessionEvents::OnGroupingParamChanged

OnGroupingParamChanged メソッドは、セッションのグループ化パラメーターが変更されたことをクライアントに通知します。
IAudioSessionEvents::OnIconPathChanged

OnIconPathChanged メソッドは、セッションの表示アイコンが変更されたことをクライアントに通知します。
IAudioSessionEvents::OnSessionDisconnected

OnSessionDisconnected メソッドは、オーディオ セッションが切断されたことをクライアントに通知します。
IAudioSessionEvents::OnSimpleVolumeChanged

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

OnStateChanged メソッドは、セッションのストリーム アクティビティの状態が変更されたことをクライアントに通知します。

要件

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

こちらもご覧ください

コア オーディオ インターフェイス

IAudioSessionControl::RegisterAudioSessionNotification

IAudioSessionControl::UnregisterAudioSessionNotification

WASAPI