Skip to main content

IAudioStateMonitor, interface

Fournit des méthodes permettant aux applications de bureau et aux jeux de détecter quand le niveau sonore de leurs flux audio est modifié par le système. Cela inclut des scénarios tels que les suivants :
  • Savoir quand un flux multimédia de jeu est coupé parce qu’une application audio est en cours de lecture en arrière-plan, ou
  • Savoir quand arrêter un flux audio de conversation de jeu parce qu’un appel VOIP a démarré 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 inclut des scénarios dans lesquels un jeu ou une application doit déterminer les éléments suivants :
  • Le moment où un flux multimédia de jeu est coupé parce qu’une application audio est en cours de lecture en arrière-plan
  • Le moment où arrêter un flux audio de conversation de jeu parce qu’un appel VoIP a démarré en arrière-plan
Le niveau sonore peut être vérifié et surveillé pour les flux de rendu 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 d’appareil. Le niveau sonore qu’aurait un nouveau flux peut être vérifié avant la création du flux. Cette API équivaut à la classe Windows.Media.Audio.AudiostateMonitor, qui est disponible pour les applications UWP mais pas pour les applications de bureau et 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 possède également les types de membres suivants :

Méthodes

L’interface IAudioStateMonitor possède les méthodes suivantes :

Remarques

Pour obtenir une instance de cette interface, appelez l’une des méthodes suivantes : L’exemple de code suivant illustre le scénario dans lequel un jeu s’inscrit aux notifications de niveau audio pour ses flux de rendu audio de la catégorie AudioCategory_GameMedia. Si le niveau sonore de cette catégorie est coupé, le jeu arrête la lecture de son flux multimédia de jeu. Si le niveau sonore a une 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