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