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.

Pour obtenir un exemple de code qui implémente une interface IAudioSessionEvents , consultez Événements de session audio. Pour obtenir un exemple de code qui inscrit l’interface IAudioSessionEvents d’un client pour recevoir des notifications, consultez Événements audio pour les applications audio héritées.

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

Interfaces audio principales

IAudioSessionControl ::RegisterAudioSessionNotification

IAudioSessionControl ::UnregisterAudioSessionNotification

WASAPI