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