Skip to main content

CreateCaptureAudioStateMonitor

[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 captura de audio.

Sintaxis

Parámetros

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
Considere el siguiente escenario, en el que un juego quiere activar su funcionalidad de GameChat en el juego solo cuando sabe que las directivas del sistema operativo no silenciarán el audio. Para ello, el juego se registra para recibir notificaciones de SoundLevel de la categoría de secuencia AudioCategory_GameChat en el punto de conexión de comunicaciones predeterminado. Si el SoundLevel de esta categoría se establece en ‘Muted’, el juego detiene su sesión de GameChat. Si el SoundLevel se establece en cualquier otro valor, el juego elige habilitar su secuencia de GameChat. En el siguiente ejemplo de código se muestra cómo el juego puede crear un objeto IAudioStateMonitor adecuado para este escenario.

Requisitos

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

Documentación conceptual

Consulte también

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