Função auxGetVolume (mmeapi.h)

A função auxGetVolume recupera a configuração de volume atual do dispositivo de saída auxiliar especificado.

Sintaxe

MMRESULT auxGetVolume(
  UINT    uDeviceID,
  LPDWORD pdwVolume
);

Parâmetros

uDeviceID

Identificador do dispositivo de saída auxiliar a ser consultado.

pdwVolume

Ponteiro para uma variável a ser preenchida com a configuração de volume atual. A palavra de baixa ordem desse local contém a configuração de volume do canal esquerdo e a palavra de alta ordem contém a configuração do canal direito. Um valor de 0xFFFF representa o volume completo e um valor de 0x0000 é o silêncio.

Se um dispositivo não der suporte ao controle de volume esquerdo e direito, a palavra de ordem baixa do local especificado conterá o nível de volume.

As configurações completas de 16 bits definidas com a função auxSetVolume são retornadas, independentemente de o dispositivo dar suporte aos 16 bits completos do controle de nível de volume.

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 um 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 um 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).

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