Partilhar via

Controles de volume

Os clientes que gerenciam fluxos de modo compartilhado normalmente usam o ISimpleAudioVolume e interfaces IAudioSessionEvents em WASAPI para controlar e monitorar os níveis de volume do fluxo. Através dos métodos na interface ISimpleAudioVolume do, o cliente pode obter e definir os níveis de volume das sessões de áudio às quais os fluxos de modo compartilhado pertencem. Se o Sndvol ou outro aplicativo alterar o nível de volume da sessão, o cliente poderá receber uma notificação da alteração por meio da interface IAudioSessionEvents do.

Os clientes que gerenciam fluxos de modo exclusivo normalmente usam o IAudioEndpointVolume e interfaces de IAudioEndpointVolumeCallback no da API EndpointVolume para controlar e monitorar os níveis de volume do fluxo. Através dos métodos na interface IAudioEndpointVolume, o cliente pode obter e definir o nível de volume de um dispositivo de ponto final de áudio . Se o Sndvol ou outro aplicativo alterar o nível de volume do dispositivo de ponto de extremidade, o cliente poderá receber uma notificação da alteração por meio da interface IAudioEndpointVolumeCallback.

Como explicado em Audio Sessions, Sndvol é o programa de controle de volume do sistema. Ele exibe controles de volume para os dispositivos de ponto de extremidade de renderização de áudio no sistema. (Atualmente, ele não exibe os controles de volume para dispositivos de ponto de extremidade de captura de áudio.) Para exibir os controles de volume de um dispositivo específico, clique em Dispositivo na barra de menus e selecione um nome de dispositivo na lista de dispositivos disponíveis.

A janela Sndvol separa os controles de volume de um dispositivo em dois grupos. A caixa de grupo no lado esquerdo da janela está rotulada Device. A caixa Device contém um único controle de volume que é controlado pela interfaceIAudioEndpointVolume. As alterações feitas pelo usuário nesse controle de volume podem ser monitoradas por meio da interfaceIAudioEndpointVolumeCallback.

A caixa de grupo no lado direito da janela do Sndvol é rotulada Aplicativos. A caixa Aplicativos contém os controles de volume para os aplicativos que atualmente compartilham o dispositivo. Para aplicativos que usam o dispositivo no modo compartilhado, os controles de volume representam os níveis de volume que são controlados pelo interface de ISimpleAudioVolume. As alterações que o usuário faz nesses controles de volume podem ser monitoradas por meio da interfaceIAudioSessionEvents.

Embora um aplicativo de modo compartilhado possa usar sua interfaceIAudioSessionEventspara monitorar as alterações que o usuário faz no controle de volume do aplicativo na caixa Aplicativos na janela Sndvol, o aplicativo não pode monitorar alterações nos controles de volume de outros aplicativos não relacionados. Da mesma forma, um aplicativo pode alterar os níveis de volume de suas sessões de áudio por meio da interfaceISimpleAudioVolume, mas não pode alterar os níveis de volume de sessões que pertencem a outros aplicativos não relacionados.

No entanto, dois ou mais aplicativos relacionados (ou instâncias do mesmo aplicativo) podem compartilhar o mesmo controle de volume na caixa Aplicativos na janela do Sndvol atribuindo seus fluxos de áudio à mesma sessão de processo cruzado ou associando suas respetivas sessões ao mesmo parâmetro de agrupamento. Para obter mais informações, consulte sessões de áudio e Parâmetros de agrupamento.

WASAPI fornece duas interfaces adicionais, IChannelAudioVolume e IAudioStreamVolume, para controlar os níveis de volume de fluxos de modo compartilhado. Essas interfaces são usadas principalmente por clientes especializados que exigem controle sobre os níveis de volume de canais individuais em uma sessão ou fluxos individuais em uma sessão.

O DeviceTopology API permite que os clientes acessem os controles de volume nas topologias de adaptadores de áudio. No entanto, os clientes que gerenciam fluxos de modo exclusivo normalmente usam a API EndpointVolume em vez da API DeviceTopology para controlar os níveis de volume de fluxo. A API EndpointVolume simplifica o controle do volume de um dispositivo de ponto de extremidade de duas maneiras. Primeiro, se um dispositivo de ponto de extremidade implementar um controle de volume de hardware, a API DeviceTopology exigirá que o cliente percorra a topologia do dispositivo em busca do controle de hardware. Por outro lado, a API EndpointVolume localiza automaticamente o controle de volume de hardware para o cliente. Em segundo lugar, se o dispositivo de ponto de extremidade não implementar um controle de volume de hardware, um cliente DeviceTopology deverá implementar um controle de volume no software. Por outro lado, a API EndpointVolume substitui automaticamente um controle de volume de software pelo controle de hardware ausente.

As seções a seguir descrevem controles de volume para sessões de áudio e para dispositivos de ponto de extremidade de áudio:

Guia de Programação

 

 

  • Last updated on