Interfaz IAudioStreamVolume (audioclient.h)

La interfaz IAudioStreamVolume permite a un cliente controlar y supervisar los niveles de volumen de todos los canales de una secuencia de audio. El cliente obtiene una referencia a la interfaz IAudioStreamVolume en un objeto de secuencia llamando al método IAudioClient::GetService con el parámetro riid establecido en REFIID IID_IAudioStreamVolume.

El nivel de volumen efectivo de cualquier canal de la submezcla de sesión, como se escucha en los altavoces, es el producto de los siguientes cuatro factores de nivel de volumen:

• Los niveles de volumen por canal de las secuencias de la sesión, que los clientes pueden controlar a través de los métodos de la interfaz IAudioStreamVolume .
• Nivel de volumen por canal de la sesión, que los clientes pueden controlar a través de los métodos de la interfaz IChannelAudioVolume .
• Nivel de volumen maestro de la sesión, que los clientes pueden controlar a través de los métodos de la interfaz ISimpleAudioVolume .
• El nivel de volumen basado en directivas de la sesión, que el sistema asigna dinámicamente a la sesión a medida que cambia la combinación global.

Cada uno de los cuatro factores de nivel de volumen de la lista anterior es un valor del intervalo de 0,0 a 1,0, donde 0,0 indica silencio y 1,0 indica volumen completo (sin atenuación). El nivel de volumen efectivo también es un valor del intervalo de 0,0 a 1,0.

Al liberar una instancia de interfaz IAudioStreamVolume , el cliente debe llamar al método Release de la interfaz desde el mismo subproceso que la llamada a IAudioClient::GetService que creó el objeto.

La interfaz IAudioStreamVolume controla los volúmenes del canal en una secuencia de audio en modo compartido. Esta interfaz no funciona con secuencias en modo exclusivo. Para obtener información sobre los controles de volumen para flujos en modo exclusivo, consulte EndpointVolume API.

Herencia

La interfaz IAudioStreamVolume hereda de la interfaz IUnknown . IAudioStreamVolume también tiene estos tipos de miembros:

Métodos

La interfaz IAudioStreamVolume tiene estos métodos.

IAudioStreamVolume::GetAllVolumes El método GetAllVolumes recupera los niveles de volumen de todos los canales de la secuencia de audio.
IAudioStreamVolume::GetChannelCount El método GetChannelCount recupera el número de canales en la secuencia de audio.
IAudioStreamVolume::GetChannelVolume El método GetChannelVolume recupera el nivel de volumen del canal especificado en la secuencia de audio.
IAudioStreamVolume::SetAllVolumes El método SetAllVolumes establece los niveles de volumen individuales para todos los canales de la secuencia de audio.
IAudioStreamVolume::SetChannelVolume El método SetChannelVolume establece el nivel de volumen del canal especificado en la secuencia de audio.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	audioclient.h

Consulte también

Interfaces de audio principales

IAudioClient::GetService

IChannelAudioVolume (interfaz)

ISimpleAudioVolume (interfaz)

WASAPI