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

Weitere Informationen

Kern-Audioschnittstellen

IAudioClient::GetService

IAudioClient::Initialize

IAudioSessionManager::GetAudioSessionControl

WASAPI