Função auxSetVolume (mmeapi.h)

A função auxSetVolume define o volume do dispositivo de saída auxiliar especificado.

Sintaxe

MMRESULT auxSetVolume(
  UINT  uDeviceID,
  DWORD dwVolume
);

Parâmetros

uDeviceID

Identificador do dispositivo de saída auxiliar a ser consultado. Os identificadores de dispositivo são determinados implicitamente a partir do número de dispositivos presentes no sistema. Os valores do identificador de dispositivo variam de zero a um menor que o número de dispositivos presentes. Use a função auxGetNumDevs para determinar o número de dispositivos auxiliares no sistema.

dwVolume

Especifica a nova configuração de volume. A palavra de baixa ordem especifica a configuração de volume do canal esquerdo e a palavra de alta ordem especifica a configuração de canal direito. Um valor de 0xFFFF representa o volume completo e um valor de 0x0000 é o silêncio.

Se um dispositivo não oferecer suporte ao controle de volume esquerdo e direito, a palavra de baixa ordem dwVolume especificará o nível de volume e a palavra de alta ordem será ignorada.

Retornar valor

Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno	Descrição
MMSYSERR_BADDEVICEID	O identificador de dispositivo especificado está fora do intervalo.

Comentários

Nem todos os dispositivos dão suporte ao controle de volume. Para determinar se o dispositivo dá suporte ao controle de volume, use o sinalizador AUXCAPS_VOLUME para testar o membro dwSupport da estrutura AUXCAPS (preenchido pela função auxGetDevCaps ).

Para determinar se o dispositivo dá suporte ao controle de volume nos canais esquerdo e direito, use o sinalizador AUXCAPS_LRVOLUME para testar o membro dwSupport da estrutura AUXCAPS (preenchido por auxGetDevCaps).

A maioria dos dispositivos não dá suporte a 16 bits completos de controle de nível de volume e usará apenas os bits de alta ordem da configuração de volume solicitada. Por exemplo, para um dispositivo que dá suporte a 4 bits de controle de volume, os valores de nível de volume solicitados de 0x4000, 0x4FFF e 0x43BE produzirão a mesma configuração de volume físico, 0x4000. A função auxGetVolume retornará a configuração completa de 16 bits definida com auxSetVolume.

As configurações de volume são interpretadas logaritmoticamente. Isso significa que o aumento de volume percebido é o mesmo ao aumentar o nível de volume de 0x5000 para 0x6000 como é de 0x4000 para 0x5000.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mmeapi.h (inclua Windows.h)
Biblioteca	Winmm.lib
DLL	Winmm.dll

Confira também

Áudio de forma de onda

Funções waveform