Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |