Skip to main content

CreateCaptureAudioStateMonitor

[Certaines informations concernent un produit en préversion susceptible d’être modifié de manière substantielle avant sa commercialisation. Microsoft n’offre aucune garantie, expresse ou implicite, concernant les informations fournies ici.] Crée une nouvelle instance de IAudioStateMonitor qui surveille le niveau audio de tous les flux de capture audio.

Syntaxe

Paramètres

audioStateMonitor _Out_ Type : IAudioStateMonitor** Ce paramètre de sortie reçoit l’objet IAudioStateMonitor créé.

Valeur de retour

Type : HRESULT Si la méthode réussit, elle renvoie S\_OK.

Remarques

Il s’agit de l’une des fonctions qui créent et renvoient une instance AudioStateMonitor. Il existe quatre variantes, pour les flux de capture comme pour les flux de rendu, qui déterminent si un processus peut effectuer l’une des opérations suivantes pour un rôle donné :
  • Capturer ou rendre tout audio de n’importe quelle catégorie
  • Capturer ou rendre l’audio d’une catégorie précise
  • Capturer ou rendre l’audio d’une catégorie précise vers un point de terminaison précis.
    Le point de terminaison peut être spécifié à l’aide de l’ID MMDevice (obtenu à l’aide de IMMDevice::GetId()) ou de son ID SWD (obtenu à l’aide de Windows.Devices.Enumeration ou de Windows.Media.Devices.MediaDevice)
  • Capturer ou rendre l’audio d’une catégorie précise vers le point de terminaison par défaut
Prenons le scénario suivant, dans lequel un jeu souhaite activer sa fonctionnalité GameChat en jeu uniquement lorsqu’il sait que l’audio ne sera pas mis en sourdine par les stratégies du système d’exploitation. Pour ce faire, le jeu s’inscrit aux notifications SoundLevel pour la catégorie de flux AudioCategory_GameChat sur le point de terminaison de communications par défaut. Si le SoundLevel de cette catégorie est défini sur « Muted », le jeu arrête sa session GameChat. Si le SoundLevel est défini sur toute autre valeur, le jeu choisit d’activer son flux GameChat. L’exemple de code suivant montre comment le jeu peut créer un objet IAudioStateMonitor approprié pour ce scénario.

Configuration requise

En-tête : Audiostatemonitorapi.h Bibliothèque : Windows.Media.MediaControl.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

AUDIO_STREAM_CATEGORY À propos de WASAPI WASAPI
Last modified on October 6, 2026