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

こちらもご覧ください

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

IAudioClient::GetService

IAudioClient::Initialize

IAudioSessionManager::GetAudioSessionControl

WASAPI