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 IAudioSessionEvents-Schnittstelle stellt Benachrichtigungen zu sitzungsbezogenen Ereignissen bereit, z. B. Änderungen der Volumeebene, des Anzeigenamens und des Sitzungszustands. Im Gegensatz zu den anderen Schnittstellen in diesem Abschnitt, die von der WASAPI-Systemkomponente implementiert werden, implementiert ein WASAPI-Client die IAudioSessionEvents-Schnittstelle . Um Ereignisbenachrichtigungen zu empfangen, übergibt der Client einen Zeiger auf seine IAudioSessionEvents-Schnittstelle an die IAudioSessionControl::RegisterAudioSessionNotification-Methode .
Nach der Registrierung seiner IAudioClientSessionEvents-Schnittstelle empfängt der Client Ereignisbenachrichtigungen in Form von Rückrufen über die Methoden in der Schnittstelle.
Bei der Implementierung der IAudioSessionEvents-Schnittstelle sollte der Client diese Regeln beachten, um Deadlocks und nicht definiertes Verhalten zu vermeiden:
- Die Methoden in der -Schnittstelle müssen nicht blockiert werden. Der Client sollte während eines Ereignisrückrufs niemals auf ein Synchronisierungsobjekt warten.
- Der Client sollte während eines Ereignisrückrufs niemals die IAudioSessionControl::UnregisterAudioSessionNotification-Methode aufrufen.
- Der Client sollte während eines Ereignisrückrufs niemals den endgültigen Verweis auf ein WASAPI-Objekt freigeben.
Vererbung
Die IAudioSessionEvents-Schnittstelle erbt von der IUnknown-Schnittstelle . IAudioSessionEvents verfügt auch über folgende Arten von Membern:
Methoden
Die IAudioSessionEvents-Schnittstelle verfügt über diese Methoden.
|
IAudioSessionEvents::OnChannelVolumeChanged Die OnChannelVolumeChanged-Methode benachrichtigt den Client, dass sich die Lautstärke eines Audiokanals im Sitzungsuntermix geändert hat. |
|
IAudioSessionEvents::OnDisplayNameChanged Die OnDisplayNameChanged-Methode benachrichtigt den Client, dass der Anzeigename für die Sitzung geändert wurde. |
|
IAudioSessionEvents::OnGroupingParamChanged Die OnGroupingParamChanged-Methode benachrichtigt den Client, dass der Gruppierungsparameter für die Sitzung geändert wurde. |
|
IAudioSessionEvents::OnIconPathChanged Die OnIconPathChanged-Methode benachrichtigt den Client, dass das Anzeigesymbol für die Sitzung geändert wurde. |
|
IAudioSessionEvents::OnSessionDisconnected Die OnSessionDisconnected-Methode benachrichtigt den Client, dass die Audiositzung getrennt wurde. |
|
IAudioSessionEvents::OnSimpleVolumeChanged Die OnSimpleVolumeChanged-Methode benachrichtigt den Client, dass sich die Lautstärke oder der Stummschaltungszustand der Audiositzung geändert hat. |
|
IAudioSessionEvents::OnStateChanged Die OnStateChanged-Methode benachrichtigt den Client, dass sich der Streamaktivitätszustand der Sitzung geändert hat. |
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
IAudioSessionControl::RegisterAudioSessionNotification