Skip to main content

CreateCaptureAudioStateMonitorForCategoryAndDeviceRole

Crea una nueva instancia de IAudioStateMonitor que supervisa el nivel de audio de todas las secuencias de captura 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 captura 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 captura 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 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 detendrá 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

Consulte también

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