Partilhar via


EndpointVolume

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 seguintes seções.

Descrição

Este exemplo demonstra os seguintes recursos.

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

Requerimentos

Produto Versão
SDK do Windows Janelas 7
Estúdio Visual 2008

 

Download do 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\...

 

Construindo a amostra

Para criar o exemplo x, use as seguintes etapas:

Para criar o exemplo EndpointVolumeChanger, use as seguintes etapas:

  1. Abra o shell CMD para o SDK do Windows e mude 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 a configuração Debug ou Release solution, selecione o menu Build na barra de menus e selecione a opção Build. Se você não abrir o Visual Studio a partir do shell CMD para o SDK, o Visual Studio não terá acesso ao ambiente de compilação 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ê compilar 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 final de áudio em uma etapa. .
-até Incrementa o nível de volume no dispositivo de ponto final de áudio em uma etapa.
-- Diminui o nível de volume no dispositivo de ponto final de áudio em uma etapa.
-para baixo Diminui o nível de volume no dispositivo de ponto final de áudio em uma etapa.
-v Define o nível de volume mestre no dispositivo de ponto de extremidade de áudio.
-consola 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.
-parâmetro de avaliação final Use o identificador de ponto de extremidade especificado no valor do switch.

 

Se o aplicativo for executado sem argumentos, ele enumerará os dispositivos disponíveis e solicitará 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 os interruptores descritos 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 EndpointVolume API.

exemplos de SDK que usam as APIs de áudio principais