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.

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

Confira também

Áudio de forma de onda

Funções waveform