Interface IAudioSessionEvents (audiopolicy.h)
L’interface IAudioSessionEvents fournit des notifications d’événements liés à la session, tels que les modifications apportées au niveau du volume, au nom d’affichage et à l’état de la session. Contrairement aux autres interfaces de cette section, qui sont implémentées par le composant système WASAPI, un client WASAPI implémente l’interface IAudioSessionEvents . Pour recevoir des notifications d’événements, le client passe un pointeur vers son interface IAudioSessionEvents vers la méthode IAudioSessionControl ::RegisterAudioSessionNotification .
Après avoir inscrit son interface IAudioClientSessionEvents , le client reçoit des notifications d’événements sous forme de rappels via les méthodes de l’interface.
Lors de l’implémentation de l’interface IAudioSessionEvents , le client doit respecter ces règles pour éviter les blocages et les comportements non définis :
- Les méthodes de l’interface doivent être non bloquantes. Le client ne doit jamais attendre un objet de synchronisation pendant un rappel d’événement.
- Le client ne doit jamais appeler la méthode IAudioSessionControl ::UnregisterAudioSessionNotification pendant un rappel d’événement.
- Le client ne doit jamais publier la référence finale sur un objet WASAPI pendant un rappel d’événement.
Héritage
L’interface IAudioSessionEvents hérite de l’interface IUnknown. IAudioSessionEvents a également les types de membres suivants :
Méthodes
L’interface IAudioSessionEvents possède ces méthodes.
IAudioSessionEvents ::OnChannelVolumeChanged La méthode OnChannelVolumeChanged informe le client que le niveau de volume d’un canal audio dans le sous-mix de session a changé. |
IAudioSessionEvents ::OnDisplayNameChanged La méthode OnDisplayNameChanged avertit le client que le nom d’affichage de la session a changé. |
IAudioSessionEvents ::OnGroupingParamChanged La méthode OnGroupingParamChanged informe le client que le paramètre de regroupement de la session a changé. |
IAudioSessionEvents ::OnIconPathChanged La méthode OnIconPathChanged avertit le client que l’icône d’affichage de la session a changé. |
IAudioSessionEvents ::OnSessionDisconnected La méthode OnSessionDisconnected avertit le client que la session audio a été déconnectée. |
IAudioSessionEvents ::OnSimpleVolumeChanged La méthode OnSimpleVolumeChanged avertit le client que le niveau de volume ou l’état de désactivation de la session audio a changé. |
IAudioSessionEvents ::OnStateChanged La méthode OnStateChanged avertit le client que l’état de l’activité de flux de la session a changé. |
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista [applications de bureau | applications UWP] |
Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
Plateforme cible | Windows |
En-tête | audiopolicy.h |
Voir aussi
IAudioSessionControl ::RegisterAudioSessionNotification
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour