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 inclui as seções a seguir.

• Descrição
• Requisitos
• Baixar o exemplo
• Criar o exemplo
• Executando o exemplo
• Tópicos relacionados

Descrição

Este exemplo demonstra os seguintes recursos.

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

Requisitos

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

 

Baixar o exemplo

Este exemplo está disponível nos seguintes locais.

Localidade	Caminho/URL
SDK do Windows	\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 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 a configuração da solução Depurar ou Liberar, selecione o menu Construir na barra de menus e selecione a opção Compilar. Se você não abrir o Visual Studio 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 uma janela de comando seguida de 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.

Argument	Descrição
-?	Mostra ajuda.
-h	Mostra ajuda.
-+	Incrementa o nível de volume no dispositivo de ponto de extremidade de áudio em uma etapa. .
-up	Incrementa o nível de volume no dispositivo de ponto de extremidade de áudio em uma etapa.
--	Diminui o nível de volume no dispositivo de ponto de extremidade de áudio em uma etapa.
-abaixo	Diminui o nível de volume no dispositivo de ponto de extremidade de áudio em 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 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 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 EndpointVolume API.

Tópicos relacionados

Exemplos de SDK que usam as APIs de áudio principais