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

\[Parte de la información se refiere a un producto en versión preliminar que puede sufrir modificaciones sustanciales antes de su lanzamiento comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información que se proporciona aquí.]

Crea una nueva instancia de [IAudioStateMonitor](/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor) que supervisa el nivel de audio de todas las secuencias de representación de audio de la categoría especificada para el punto de conexión de audio con el identificador de `device` especificado.

## Sintaxis

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

### Parámetros

*category*\
Tipo: AUDIO\_STREAM\_CATEGORY

Un miembro de la enumeración **AUDIO\_STREAM\_CATEGORY** que especifica la categoría de las secuencias de representación de audio que se van a supervisar.

*deviceId*\
Tipo: PCWSTR

Un identificador de `device` que especifica el punto de conexión de audio para el que se supervisan las secuencias de representación de audio.

*audioStateMonitor* \_Out\_\
Tipo: IAudioStateMonitor\*\*

Este parámetro de salida se rellena con el objeto `IAudioStateMonitor` creado.

### Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, devuelve `S\_OK`.

## Comentarios

Esta es una de las funciones que crean y devuelven una instancia de `AudioStateMonitor`.

Hay cuatro variantes para las secuencias de captura y otras cuatro para las de representación, que determinan si un proceso puede hacer una de las siguientes acciones para un rol determinado:

* Capturar o representar cualquier audio de cualquier categoría
* Capturar o representar audio de una categoría específica
* Capturar o representar audio de una categoría específica, en un punto de conexión específico.\
  El punto de conexión puede especificarse mediante el identificador `MMDevice` (obtenido mediante `IMMDevice::GetId()`) o mediante su identificador `SWD` (obtenido mediante `Windows.Devices.Enumeration` o `Windows.Media.Devices.MediaDevice`)
* Capturar o representar audio de una categoría específica en el punto de conexión predeterminado

## Requisitos

**Encabezado:** Audiostatemonitorapi.h

**Biblioteca:** Windows.Media.MediaControl.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[AUDIO\_STREAM\_CATEGORY](https://learn.microsoft.com/windows/win32/api/audiosessiontypes/ne-audiosessiontypes-audio_stream_category)

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

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

[Información general de audio](/build/console-features/audio/overviews/audio)


## Related topics

- [Interfaz IAudioStateMonitor](/es/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor.md)
- [AudioStateMonitor](/es/reference/audio/audiostatemonitor/audiostatemonitor_members.md)
- [CreateRenderAudioStateMonitorForCategory](/es/reference/audio/audiostatemonitor/functions/createrenderaudiostatemonitorforcategory.md)
- [CreateRenderAudioStateMonitorForCategoryAndDeviceRole](/es/reference/audio/audiostatemonitor/functions/createrenderaudiostatemonitorforcategoryanddevicerole.md)
- [CreateCaptureAudioStateMonitorForCategoryAndDeviceId](/es/reference/audio/audiostatemonitor/functions/createcaptureaudiostatemonitorforcategoryanddeviceid.md)