Partager via


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