Skip to main content

CreateRenderAudioStateMonitorForCategoryAndDeviceRole

[Certaines informations concernent un produit en version préliminaire susceptible d’être considérablement modifié 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 restitution audio de la catégorie spécifiée et ayant le rôle spécifié.

Syntaxe

Paramètres

category
Type : AUDIO_STREAM_CATEGORY
Membre de l’énumération AUDIO_STREAM_CATEGORY qui spécifie la catégorie des flux de restitution audio à surveiller. role
Type : ERole
Membre de l’énumération ERole qui spécifie le rôle des flux de restitution audio à surveiller. audioStateMonitor _Out_
Type : IAudioStateMonitor**
Ce paramètre de sortie est rempli avec l’objet IAudioStateMonitor créé.

Valeur de retour

Si la méthode réussit, elle retourne S\_OK.

Remarques

Il s’agit de l’une des fonctions qui créent et retournent une instance d’AudioStateMonitor. Il existe quatre variantes pour chacun des flux de capture et de restitution, qui déterminent si un processus peut effectuer l’une des actions suivantes pour un rôle donné :
  • Capturer ou restituer tout audio de n’importe quelle catégorie
  • Capturer ou restituer de l’audio d’une catégorie particulière
  • Capturer ou restituer de l’audio d’une catégorie particulière, vers un point de terminaison particulier
    Le point de terminaison peut être spécifié à l’aide de l’ID MMDevice (obtenu à l’aide de IMMDevice::GetId()), ou à l’aide de son ID SWD (obtenu à l’aide de Windows.Devices.Enumeration ou de Windows.Media.Devices.MediaDevice)
  • Capturer ou restituer de l’audio d’une catégorie particulière vers le point de terminaison par défaut
Considérez le scénario suivant, dans lequel un jeu choisit de lire de l’audio GameMedia uniquement lorsqu’il est connu que l’audio ne sera pas mis en sourdine par le système d’exploitation en raison d’une stratégie. Pour ce faire, le jeu s’inscrit aux notifications SoundLevel pour la catégorie de flux AudioCategory_GameMedia sur le point de terminaison de console par défaut. Si le SoundLevel de cette catégorie est réglé à ‘Muted’, le jeu arrêtera la lecture de son flux GameMedia. Si le SoundLevel est réglé à toute autre valeur, le jeu choisit de lire son flux GameMedia.

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

Voir aussi

AUDIO_STREAM_CATEGORY À propos de WASAPI WASAPI Vue d’ensemble de l’audio
Last modified on October 6, 2026