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