Skip to main content

CreateCaptureAudioStateMonitorForCategoryAndDeviceId

[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 instance de IAudioStateMonitor qui surveille le niveau audio de tous les flux de capture audio de la catégorie spécifiée pour le point de terminaison audio ayant l’ID device 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 capture audio à surveiller. deviceId
Type : PCWSTR
ID d’appareil spécifiant le point de terminaison audio dont les flux de capture audio sont surveillés. audioStateMonitor _Out_
Type : IAudioStateMonitor**
Ce paramètre de sortie reçoit l’objet IAudioStateMonitor créé.

Valeur renvoyée

Type : HRESULT 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 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 restituer n’importe quel audio de n’importe quelle catégorie
  • Capturer ou restituer l’audio d’une catégorie spécifique
  • Capturer ou restituer l’audio d’une catégorie spécifique, vers un point de terminaison spécifique.
    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 Windows.Media.Devices.MediaDevice)
  • Capturer ou restituer l’audio d’une catégorie spécifique vers le point de terminaison par défaut

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 XAudio2 Vue d’ensemble de l’audio
Last modified on October 6, 2026