Interface IAudioStreamVolume (audioclient.h)

A interface IAudioStreamVolume permite que um cliente controle e monitore os níveis de volume de todos os canais em um fluxo de áudio. O cliente obtém uma referência à interface IAudioStreamVolume em um objeto de fluxo chamando o método IAudioClient::GetService com o parâmetro riid definido como REFIID IID_IAudioStreamVolume.

O nível de volume efetivo de qualquer canal no submix de sessão, conforme ouvido nos alto-falantes, é o produto dos quatro fatores de nível de volume a seguir:

• Os níveis de volume por canal dos fluxos na sessão, que os clientes podem controlar por meio dos métodos na interface IAudioStreamVolume .
• O nível de volume por canal da sessão, que os clientes podem controlar por meio dos métodos na interface IChannelAudioVolume .
• O master nível de volume da sessão, que os clientes podem controlar por meio dos métodos na interface ISimpleAudioVolume.
• O nível de volume baseado em política da sessão, que o sistema atribui dinamicamente à sessão à medida que a combinação global é alterada.

Cada um dos quatro fatores de nível de volume na lista anterior é um valor no intervalo de 0,0 a 1,0, em que 0,0 indica silêncio e 1,0 indica volume completo (sem atenuação). O nível de volume efetivo também é um valor no intervalo de 0,0 a 1,0.

Ao liberar uma instância de interface IAudioStreamVolume , o cliente deve chamar o método Release da interface do mesmo thread que a chamada para IAudioClient::GetService que criou o objeto.

A interface IAudioStreamVolume controla os volumes de canal em um fluxo de áudio de modo compartilhado. Essa interface não funciona com fluxos de modo exclusivo. Para obter informações sobre controles de volume para fluxos de modo exclusivo, consulte API EndpointVolume.

Herança

A interface IAudioStreamVolume herda da interface IUnknown . IAudioStreamVolume também tem estes tipos de membros:

Métodos

A interface IAudioStreamVolume tem esses métodos.

IAudioStreamVolume::GetAllVolumes O método GetAllVolumes recupera os níveis de volume para todos os canais no fluxo de áudio.
IAudioStreamVolume::GetChannelCount O método GetChannelCount recupera o número de canais no fluxo de áudio.
IAudioStreamVolume::GetChannelVolume O método GetChannelVolume recupera o nível de volume do canal especificado no fluxo de áudio.
IAudioStreamVolume::SetAllVolumes O método SetAllVolumes define os níveis de volume individuais para todos os canais no fluxo de áudio.
IAudioStreamVolume::SetChannelVolume O método SetChannelVolume define o nível de volume para o canal especificado no fluxo de áudio.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	audioclient.h

Confira também

Principais interfaces de áudio

IAudioClient::GetService

IChannelAudioVolume Interface

ISimpleAudioVolume Interface

WASAPI