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.
Die IAudioSessionControl-Schnittstelle erbt von der IUnknown-Schnittstelle . IAudioSessionControl verfügt auch über die folgenden Typen von Membern:
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. |
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 |