Share via

Função midiOutGetVolume (mmeapi.h)

  • Artigo

A função midiOutGetVolume recupera a configuração de volume atual de um dispositivo de saída MIDI.

Sintaxe

MMRESULT midiOutGetVolume(
  HMIDIOUT hmo,
  LPDWORD  pdwVolume
);

Parâmetros

hmo

Identificador para um dispositivo de saída MIDI aberto. Esse parâmetro também pode conter o identificador de um fluxo MIDI, desde que seja convertido em HMIDIOUT. Esse parâmetro também pode ser um identificador de dispositivo.

pdwVolume

Ponteiro para o local para conter 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 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 ordem baixa do local especificado conterá o nível de volume mono.

Qualquer valor definido usando a função midiOutSetVolume é retornado, independentemente de o dispositivo dar suporte a esse valor.

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_INVALHANDLE
 O identificador de dispositivo especificado é inválido.
MMSYSERR_INVALPARAM
 O ponteiro ou estrutura especificado é inválido.
MMSYSERR_NOMEM
 O sistema não pode alocar ou bloquear memória.
MMSYSERR_NOTSUPPORTED
 Não há suporte para a função .

Comentários

Se um identificador de dispositivo for usado, o resultado da chamada midiOutGetVolume e as informações retornadas em lpdwVolume se aplicarão a todas as instâncias do dispositivo. Se um identificador de dispositivo for usado, o resultado e as informações retornadas se aplicarão somente à instância do dispositivo referenciada pelo identificador do dispositivo.

Nem todos os dispositivos dão suporte ao controle de volume. Você pode determinar se um dispositivo dá suporte ao controle de volume consultando o dispositivo usando a função midiOutGetDevCaps e especificando o sinalizador MIDICAPS_VOLUME.

Você também pode determinar se o dispositivo dá suporte ao controle de volume nos canais esquerdo e direito consultando o dispositivo usando a função midiOutGetDevCaps e especificando o sinalizador MIDICAPS_LRVOLUME.

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

Funções MIDI