IAudioSessionControl インターフェイス (audiopolicy.h)
IAudioSessionControl インターフェイスを使用すると、クライアントはオーディオ セッションの制御パラメーターを構成し、セッション内のイベントを監視できます。 IAudioClient::Initialize メソッドはストリーム オブジェクトを初期化し、ストリームをオーディオ セッションに割り当てます。 クライアントは、パラメーター riid が REFIID IID_IAudioSessionControlに設定された IAudioClient::GetService メソッドを呼び出して、ストリーム オブジェクトの IAudioSessionControl インターフェイスへの参照を取得します。
または、クライアントは、最初にストリーム オブジェクトを作成してセッションにストリームを追加しなくても、既存のセッションの IAudioSessionControl インターフェイスを取得できます。 代わりに、クライアントは、パラメーター AudioSessionGuid をセッション GUID に設定して、IAudioSessionManager::GetAudioSessionControl メソッドを呼び出します。
クライアントは、 クライアントが IAudioSessionControl インターフェイスのメソッドを使用してセッション パラメーターを変更したときに、セッション マネージャーから通知を受け取るために登録できます。
IAudioSessionControl インターフェイス インスタンスを解放する場合、クライアントは、オブジェクトを作成した IAudioClient::GetService の呼び出しと同じスレッドからインターフェイスの Release メソッドを呼び出す必要があります。
IAudioSessionControl インターフェイスは、オーディオ セッションを制御します。 オーディオ セッションは、共有モード ストリームのコレクションです。 このインターフェイスは、排他モード ストリームでは機能しません。
IAudioSessionControl インターフェイスを使用するコード例については、「レガシ オーディオ アプリケーションのオーディオ イベント」を参照してください。
継承
IAudioSessionControl インターフェイスは、IUnknown インターフェイスから継承されます。 IAudioSessionControl には、次の種類のメンバーもあります。
メソッド
IAudioSessionControl インターフェイスには、これらのメソッドがあります。
| IAudioSessionControl::GetDisplayName GetDisplayName メソッドは、オーディオ セッションの表示名を取得します。 |
| IAudioSessionControl::GetGroupingParam GetGroupingParam メソッドは、オーディオ セッションのグループ化パラメーターを取得します。 |
| IAudioSessionControl::GetIconPath GetIconPath メソッドは、オーディオ セッションの表示アイコンのパスを取得します。 |
| IAudioSessionControl::GetState GetState メソッドは、オーディオ セッションの現在の状態を取得します。 |
| IAudioSessionControl::RegisterAudioSessionNotification RegisterAudioSessionNotification メソッドは、ストリーム状態の変更を含むセッション イベントの通知を受信するようにクライアントを登録します。 |
| IAudioSessionControl::SetDisplayName SetDisplayName メソッドは、現在のセッションに表示名を割り当てます。 |
| IAudioSessionControl::SetGroupingParam SetGroupingParam メソッドは、セッションのグループにセッションを割り当てます。 |
| IAudioSessionControl::SetIconPath SetIconPath メソッドは、現在のセッションに表示アイコンを割り当てます。 |
| IAudioSessionControl::UnregisterAudioSessionNotification UnregisterAudioSessionNotification メソッドは、通知を受信するクライアントによる以前の登録を削除します。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | audiopolicy.h |