Skip to main content

Interface IAudioStateMonitor

Fournit des méthodes permettant aux applications de bureau et aux jeux de découvrir quand le niveau sonore de leurs flux audio est modifié par le système. Cela comprend des scénarios comme les suivants :
  • Savoir quand un flux multimédia de jeu est mis en sourdine parce qu’une application audio joue en arrière-plan, ou
  • Savoir quand arrêter un flux audio de clavardage de jeu parce qu’un appel VOIP a commencé en arrière-plan.
Fournit des méthodes qui permettent aux applications de bureau et aux jeux de déterminer le moment où le niveau sonore de leurs flux audio est modifié par le système. Cela comprend des scénarios dans lesquels un jeu ou une application doit déterminer ce qui suit :
  • Le moment où un flux multimédia de jeu est mis en sourdine parce qu’une application audio joue en arrière-plan
  • Le moment où arrêter un flux audio de clavardage de jeu parce qu’un appel VoIP a commencé en arrière-plan
Le niveau sonore peut être vérifié et surveillé pour les flux de restitution comme pour les flux de capture. Les flux surveillés peuvent être sélectionnés par catégorie, par point de terminaison audio ou par rôle de périphérique. Le niveau sonore qu’aurait un nouveau flux peut être vérifié avant la création du flux. Cette API est l’équivalent de la classe Windows.Media.Audio.AudiostateMonitor, qui est disponible pour les applications UWP, mais pas pour les applications de bureau ni les jeux. Cette interface ne peut pas être utilisée par les applications UWP.

Membres

L’interface IAudioStateMonitor hérite de l’interface IUnknown, mais comporte également ces types de membres :

Méthodes

L’interface IAudioStateMonitor comporte ces méthodes :

Remarques

Pour obtenir une instance de cette interface, appelez l’une de ces méthodes : L’exemple de code suivant illustre le scénario dans lequel un jeu s’inscrit aux notifications de niveau audio pour ses flux de restitution audio de la catégorie AudioCategory_GameMedia. Si le niveau sonore de cette catégorie est en sourdine, le jeu arrêtera la lecture de son flux multimédia de jeu. Si le niveau sonore est réglé à toute autre valeur, le flux multimédia de jeu est lu.

Configuration requise

En-tête : Audiostatemonitorapi.h Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

À propos de WASAPI
Last modified on October 6, 2026