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

# CreateRenderAudioStateMonitorForCategoryAndDeviceId

> CreateRenderAudioStateMonitorForCategoryAndDeviceId

# CreateRenderAudioStateMonitorForCategoryAndDeviceId

\[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](/fr-CA/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor) qui surveille le niveau audio de tous les flux de restitution 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 CreateRenderAudioStateMonitorForCategoryAndDeviceId(
  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 restitution audio à surveiller.

*deviceId*\
Type : PCWSTR

ID `device` qui spécifie le point de terminaison audio pour lequel les flux de restitution audio sont surveillés.

*audioStateMonitor* \_Out\_\
Type : IAudioStateMonitor\*\*

Ce paramètre de sortie est rempli avec l'objet `IAudioStateMonitor` créé.

### Valeur de retour

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

## 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 l'audio](/fr-CA/build/console-features/audio/overviews/audio)


## Related topics

- [CreateRenderAudioStateMonitorForCategoryAndDeviceId](/reference/audio/audiostatemonitor/functions/createrenderaudiostatemonitorforcategoryanddeviceid.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)