IAudioSessionEvents インターフェイス (audiopolicy.h)
IAudioSessionEvents インターフェイスは、ボリューム レベルの変更、表示名、セッション状態などのセッション関連のイベントの通知を提供します。 WASAPI システム コンポーネントによって実装されるこのセクションの他のインターフェイスとは異なり、WASAPI クライアントは IAudioSessionEvents インターフェイスを実装します。 イベント通知を受信するために、クライアントは IAudioSessionEvents インターフェイスへのポインターを IAudioSessionControl::RegisterAudioSessionNotification メソッドに 渡します。
IAudioClientSessionEvents インターフェイスを登録すると、クライアントは インターフェイスの メソッドを介してコールバックの形式でイベント通知を受け取ります。
IAudioSessionEvents インターフェイスを実装する場合、クライアントはデッドロックと未定義の動作を回避するために、次の規則を遵守する必要があります。
- インターフェイス内のメソッドは非ブロッキングである必要があります。 クライアントは、イベント コールバック中に同期オブジェクトを待機しないでください。
- クライアントは、イベント コールバック中に IAudioSessionControl::UnregisterAudioSessionNotification メソッドを呼び出さないでください。
- クライアントは、イベント コールバック中に WASAPI オブジェクトの最後の参照を解放しないでください。
継承
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