Compartilhar via

EndpointVolume

  • Artigo

Este aplicativo de exemplo usa as APIs de Áudio Principal para alterar o volume do dispositivo, conforme especificado pelo usuário.

Este tópico contém as seções a seguir.

Descrição

Este exemplo demonstra os seguintes recursos.

  • da API MMDevice para enumeração e seleção de dispositivo multimídia.
  • da API EndpointVolume para controlar os níveis de volume do ponto de extremidade do dispositivo.

Requisitos

Produto Versão
do SDK do Windows Windows 7
Visual Studio 2008

 

Baixando o exemplo

Este exemplo está disponível nos seguintes locais.

Localização Caminho/URL
Windows SDK \Arquivos de Programas\Microsoft SDKs\Windows\v7.0\Samples\Multimedia\Audio\EndpointVolume\...

 

Compilando o exemplo

Para criar o exemplo x, use as seguintes etapas:

Para criar o exemplo EndpointVolumeChanger, use as seguintes etapas:

  1. Abra o shell do CMD para o SDK do Windows e altere para o diretório de exemplo EndpointVolume.
  2. Execute o comando start EndpointVolumeChanger.sln no diretório EndpointVolume para abrir o projeto EndpointVolumeChanger na janela do Visual Studio.
  3. Na janela, selecione o de Depuração ou a configuração da solução de Versão, selecione o menu Criar na barra de menus e selecione a opção Criar. Se você não abrir o Visual Studio do shell do CMD para o SDK, o Visual Studio não terá acesso ao ambiente de build do SDK. Nesse caso, o exemplo não será compilado, a menos que você defina explicitamente a variável de ambiente MSSdk, que é usada no arquivo de projeto, WASAPIEndpointVolume.vcproj.

Executando o exemplo

Se você criar o aplicativo de demonstração com êxito, um arquivo executável, EndpointVolumeChanger.exe, será gerado. Para executá-lo, digite EndpointVolumeChanger em uma janela de comando seguida por argumentos obrigatórios ou opcionais. O exemplo a seguir mostra como alternar a configuração de mudo no dispositivo de console padrão.

EndpointVolumeChanger.exe -console -m

A tabela a seguir mostra os argumentos.

Argumento Descrição
-? Mostra ajuda.
-h Mostra ajuda.
-+ Incrementa o nível de volume no dispositivo de ponto de extremidade de áudio por uma etapa. .
-em cima Incrementa o nível de volume no dispositivo de ponto de extremidade de áudio por uma etapa.
-- Diminui o nível de volume no dispositivo de ponto de extremidade de áudio por uma etapa.
-abaixo Diminui o nível de volume no dispositivo de ponto de extremidade de áudio por uma etapa.
-v Define o nível de volume mestre no dispositivo de ponto de extremidade de áudio.
-consolar Use o dispositivo de console padrão.
-Comunicações Use o dispositivo de comunicação padrão.
-multimédia Use o dispositivo multimídia padrão.
-Extremidade Use o identificador de ponto de extremidade especificado no valor da opção.

 

Se o aplicativo for executado sem argumentos, ele enumera os dispositivos disponíveis e solicita que o usuário selecione um dispositivo. Depois que o usuário especifica o dispositivo, o aplicativo exibe as configurações de volume atuais para o ponto de extremidade. O volume pode ser controlado usando as opções descritas na tabela anterior.

Para obter mais informações sobre como controlar os níveis de volume de dispositivos de ponto de extremidade de áudio, consulte API EndpointVolume.

exemplos de SDK que usam as APIs de áudio principais