> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateCaptureAudioStateMonitorForCategoryAndDeviceId

> CreateCaptureAudioStateMonitorForCategoryAndDeviceId

# 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 nouvelle instance de [IAudioStateMonitor](/fr-CA/reference/audio/audiostatemonitor/interfaces/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

```cpp theme={null}
HRESULT WINAPI CreateCaptureAudioStateMonitorForCategoryAndDeviceId(
  AUDIO_STREAM_CATEGORY category,
  PCWSTR deviceId,
  _Out_ IAudioStateMonitor **audioStateMonitor
);
```

### 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 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

## 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](https://learn.microsoft.com/windows/win32/api/audiosessiontypes/ne-audiosessiontypes-audio_stream_category)

[À propos de WASAPI](https://learn.microsoft.com/windows/desktop/CoreAudio/wasapi)

[WASAPI](/fr-CA/build/console-features/audio/overviews/wasapi-overview)

[Vue d'ensemble de XAudio2](/fr-CA/build/console-features/audio/overviews/xaudio2-overview)

[Vue d'ensemble de l'audio](/fr-CA/build/console-features/audio/overviews/audio)


## Related topics

- [CreateCaptureAudioStateMonitorForCategoryAndDeviceId](/reference/audio/audiostatemonitor/functions/createcaptureaudiostatemonitorforcategoryanddeviceid.md)
- [IAudioStateMonitor interface](/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor.md)
- [AudioStateMonitor](/reference/audio/audiostatemonitor/audiostatemonitor_members.md)
- [Interfaz IAudioStateMonitor](/es/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor.md)
- [IAudioStateMonitor 接口](/zh-CN/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor.md)