Skip to main content

CreateRenderAudioStateMonitorForCategoryAndDeviceRole

[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 que supervisa el nivel de audio de todas las secuencias de representación de audio de la categoría especificada y con el rol especificado.

Sintaxis

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. role
Tipo: ERole
Un miembro de la enumeración ERole que especifica el rol de las secuencias de representación de audio que se van a supervisar. audioStateMonitor _Out_
Tipo: IAudioStateMonitor**
Este parámetro de salida se rellena con el objeto IAudioStateMonitor creado.

Valor devuelto

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
Considere el siguiente escenario, en el que un juego elige reproducir audio GameMedia solo cuando se sabe que el sistema operativo no silenciará el audio debido a la directiva. Para lograrlo, el juego se registra para recibir notificaciones de SoundLevel de la categoría de secuencia AudioCategory_GameMedia en el punto de conexión de consola predeterminado. Si el SoundLevel de esta categoría se establece en ‘Muted’, el juego detendrá la reproducción de su secuencia GameMedia. Si el SoundLevel se establece en cualquier otro valor, el juego elige reproducir su secuencia GameMedia.

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 Acerca de WASAPI WASAPI Información general de audio
Última modificación el 31 de agosto de 2026