Skip to main content

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

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