IAudioSessionControl-Schnittstelle (audiopolicy.h)
Die IAudioSessionControl-Schnittstelle ermöglicht es einem Client, die Steuerungsparameter für eine Audiositzung zu konfigurieren und Ereignisse in der Sitzung zu überwachen. Die IAudioClient::Initialize-Methode initialisiert ein Streamobjekt und weist den Stream einer Audiositzung zu. Der Client ruft einen Verweis auf die IAudioSessionControl-Schnittstelle für ein Streamobjekt ab, indem er die IAudioClient::GetService-Methode aufruft, wobei der Parameter riid auf REFIID IID_IAudioSessionControl festgelegt ist.
Alternativ kann ein Client die IAudioSessionControl-Schnittstelle einer vorhandenen Sitzung abrufen, ohne zuerst ein Streamobjekt erstellen und den Stream der Sitzung hinzufügen zu müssen. Stattdessen ruft der Client die IAudioSessionManager::GetAudioSessionControl-Methode auf, wobei der Parameter AudioSessionGuid auf die Sitzungs-GUID festgelegt ist.
Der Client kann sich registrieren, um Benachrichtigungen vom Sitzungs-Manager zu erhalten, wenn Clients Sitzungsparameter über die Methoden in der IAudioSessionControl-Schnittstelle ändern.
Beim Freigeben einer IAudioSessionControl-Schnittstelle instance muss der Client die Release-Methode der Schnittstelle aus demselben Thread aufrufen wie der Aufruf von IAudioClient::GetService, der das Objekt erstellt hat.
Die IAudioSessionControl-Schnittstelle steuert eine Audiositzung. Eine Audiositzung ist eine Sammlung von Streams im freigegebenen Modus. Diese Schnittstelle funktioniert nicht mit Datenströmen im exklusiven Modus.
Ein Codebeispiel, das die IAudioSessionControl-Schnittstelle verwendet, finden Sie unter Audioereignisse für Legacy-Audioanwendungen.
Vererbung
Die IAudioSessionControl-Schnittstelle erbt von der IUnknown-Schnittstelle . IAudioSessionControl verfügt auch über die folgenden Typen von Membern:
Methoden
Die IAudioSessionControl-Schnittstelle verfügt über diese Methoden.
| IAudioSessionControl::GetDisplayName Die GetDisplayName-Methode ruft den Anzeigenamen für die Audiositzung ab. |
| IAudioSessionControl::GetGroupingParam Die GetGroupingParam-Methode ruft den Gruppierungsparameter der Audiositzung ab. |
| IAudioSessionControl::GetIconPath Die GetIconPath-Methode ruft den Pfad für das Anzeigesymbol für die Audiositzung ab. |
| IAudioSessionControl::GetState Die GetState-Methode ruft den aktuellen Zustand der Audiositzung ab. |
| IAudioSessionControl::RegisterAudioSessionNotification Die RegisterAudioSessionNotification-Methode registriert den Client, um Benachrichtigungen über Sitzungsereignisse zu erhalten, einschließlich Änderungen im Streamstatus. |
| IAudioSessionControl::SetDisplayName Die SetDisplayName-Methode weist der aktuellen Sitzung einen Anzeigenamen zu. |
| IAudioSessionControl::SetGroupingParam Die SetGroupingParam-Methode weist einer Gruppierung von Sitzungen eine Sitzung zu. |
| IAudioSessionControl::SetIconPath Die SetIconPath-Methode weist der aktuellen Sitzung ein Anzeigesymbol zu. |
| IAudioSessionControl::UnregisterAudioSessionNotification Die UnregisterAudioSessionNotification-Methode löscht eine vorherige Registrierung durch den Client, um Benachrichtigungen zu empfangen. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | audiopolicy.h |