> ## 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 instance de [IAudioStateMonitor](/fr/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor) qui surveille le niveau audio de tous les flux de rendu 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 rendu audio à surveiller.

*deviceId*\
Type : PCWSTR

ID `device` qui spécifie le point de terminaison audio dont les flux de rendu 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 rendre n'importe quel audio de n'importe quelle catégorie
* Capturer ou rendre l'audio d'une catégorie spécifique
* Capturer ou rendre 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 avec `IMMDevice::GetId()`) ou à l'aide de son ID `SWD` (obtenu avec `Windows.Devices.Enumeration` ou `Windows.Media.Devices.MediaDevice`)
* Capturer ou rendre 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](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/build/console-features/audio/overviews/wasapi-overview)

[Vue d'ensemble de l'audio](/fr/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)