Skip to main content

Interfaz IAudioStateMonitor

Proporciona métodos para que las aplicaciones de escritorio y los juegos detecten cuándo el sistema modifica los niveles de sonido de sus secuencias de audio. Esto incluye escenarios como los siguientes:
  • Saber cuándo se silencia una secuencia multimedia del juego porque una aplicación de audio se está reproduciendo en segundo plano o
  • Saber cuándo detener una secuencia de audio de chat del juego porque se ha iniciado una llamada VOIP en segundo plano.
Proporciona métodos que permiten a las aplicaciones de escritorio y a los juegos determinar el momento en que el sistema modifica los niveles de sonido de sus secuencias de audio. Esto incluye escenarios en los que un juego o una aplicación necesita determinar lo siguiente:
  • El momento en que se silencia una secuencia multimedia del juego porque una aplicación de audio se está reproduciendo en segundo plano
  • El momento de detener una secuencia de audio de chat del juego porque se ha iniciado una llamada VoIP en segundo plano
El nivel de sonido se puede comprobar y supervisar tanto para las secuencias de representación como para las de captura. Las secuencias supervisadas se pueden seleccionar por categoría, punto de conexión de audio o rol de dispositivo. El nivel de sonido que tendría una nueva secuencia puede comprobarse antes de crear la secuencia. Esta API es equivalente a la clase Windows.Media.Audio.AudiostateMonitor, que está disponible para las aplicaciones para UWP pero no para las aplicaciones de escritorio ni los juegos. Las aplicaciones para UWP no pueden usar esta interfaz.

Miembros

La interfaz IAudioStateMonitor hereda de la interfaz IUnknown, pero también tiene estos tipos de miembros:

Métodos

La interfaz IAudioStateMonitor tiene estos métodos:

Comentarios

Para obtener una instancia de esta interfaz, llame a uno de estos métodos: En el siguiente código de ejemplo se muestra el escenario en el que un juego se registra para recibir notificaciones de nivel de audio de sus secuencias de representación de audio de la categoría AudioCategory_GameMedia. Si el nivel de sonido de esta categoría está silenciado, el juego detendrá la reproducción de su secuencia multimedia del juego. Si el nivel de sonido se establece en cualquier otro valor, se reproduce la secuencia multimedia del juego.

Requisitos

Encabezado: Audiostatemonitorapi.h Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

Acerca de WASAPI
Última modificación el 28 de agosto de 2026