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