IAudioSessionManager-Schnittstelle (audiopolicy.h)
Die IAudioSessionManager-Schnittstelle ermöglicht es einem Client, auf die Sitzungs- und Lautstärkesteuerungen für prozessübergreifende und prozessspezifische Audiositzungen zuzugreifen. Der Client ruft einen Verweis auf eine IAudioSessionManager-Schnittstelle ab, indem er die IMMDevice::Activate-Methodeaufruft , wobei parameter iid auf REFIID IID_IAudioSessionManager festgelegt ist.
Diese Schnittstelle ermöglicht Es Clients, auf die Steuerelemente für eine vorhandene Sitzung zuzugreifen, ohne zuerst einen Stream zu öffnen. Diese Funktion ist nützlich für Clients von APIs höherer Ebene, die auf WASAPI basieren und Sitzungssteuerelemente intern verwenden, ihren Clients jedoch keinen Zugriff auf Sitzungssteuerelemente gewähren.
In Windows Vista umfassen die ÜBERGEORDNETEN APIs, die WASAPI verwenden, Media Foundation, DirectSound, die Windows Multimedia-Funktionen waveInXxx, waveOutXxx und mciXxx sowie APIs von Drittanbietern.
Wenn ein Client einen Audiodatenstrom über eine API auf höherer Ebene erstellt, fügt diese API den Stream in der Regel der Standardaudiositzung für den Clientprozess hinzu (die Sitzung, die durch den Sitzungs-GUID-Wert identifiziert wird, GUID_NULL), aber die gleiche API stellt möglicherweise keine Möglichkeit für den Client bereit, auf die Steuerelemente für diese Sitzung zuzugreifen. In diesem Fall kann der Client über die IAudioSessionManager-Schnittstelle auf die Steuerelemente zugreifen.
Ein Codebeispiel, das die IAudioSessionManager-Schnittstelle verwendet, finden Sie unter Audioereignisse für Legacy-Audioanwendungen.
Vererbung
Die IAudioSessionManager-Schnittstelle erbt von der IUnknown-Schnittstelle . IAudioSessionManager verfügt auch über folgende Membertypen:
Methoden
Die IAudioSessionManager-Schnittstelle verfügt über diese Methoden.
| IAudioSessionManager::GetAudioSessionControl Die GetAudioSessionControl-Methode ruft ein Audiositzungssteuerelement ab. |
| IAudioSessionManager::GetSimpleAudioVolume Die GetSimpleAudioVolume-Methode ruft eine einfache Lautstärkeregelung ab. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | audiopolicy.h |