IAudioSessionManager インターフェイス (audiopolicy.h)
IAudioSessionManager インターフェイスを使用すると、クライアントはクロスプロセスとプロセス固有のオーディオ セッションの両方のセッション コントロールとボリューム コントロールにアクセスできます。 クライアントは、パラメーター iid が REFIID IID_IAudioSessionManagerに設定された IMMDevice::Activate メソッドを呼び出すことによって、IAudioSessionManager インターフェイスへの参照を取得します。
このインターフェイスを使用すると、クライアントは最初にストリームを開かずに、既存のセッションのコントロールにアクセスできます。 この機能は、WASAPI の上に構築され、内部的にセッション制御を使用しているが、クライアントにセッション制御へのアクセス権を与えない上位レベルの API のクライアントに役立ちます。
Windows Vista では、WASAPI を使用する上位レベルの API には、Media Foundation、DirectSound、Windows マルチメディア waveInXxx、 waveOutXxx、 および mciXxx 関数、およびサードパーティ API が含まれます。
クライアントが上位レベルの API を介してオーディオ ストリームを作成する場合、その API は通常、クライアントのプロセスの既定のオーディオ セッション (セッション GUID 値GUID_NULLによって識別されるセッション) にストリームを追加しますが、同じ API はクライアントがそのセッションのコントロールにアクセスするための手段を提供しない可能性があります。 その場合、クライアントは IAudioSessionManager インターフェイスを介してコントロールにアクセスできます。
IAudioSessionManager インターフェイスを使用するコード例については、「レガシ オーディオ アプリケーションのオーディオ イベント」を参照してください。
継承
IAudioSessionManager インターフェイスは、IUnknown インターフェイスから継承されます。 IAudioSessionManager には、次の種類のメンバーもあります。
メソッド
IAudioSessionManager インターフェイスには、これらのメソッドがあります。
| IAudioSessionManager::GetAudioSessionControl GetAudioSessionControl メソッドは、オーディオ セッション コントロールを取得します。 |
| IAudioSessionManager::GetSimpleAudioVolume GetSimpleAudioVolume メソッドは、単純なオーディオ ボリューム コントロールを取得します。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | audiopolicy.h |