Alterando o volume interno do sintetizador MIDI
O Windows fornece as seguintes funções para recuperar e definir o nível de volume de dispositivos sintetizadores MIDI internos:
Valor | Significado |
---|---|
midiOutGetVolume | Recupera o nível de volume do dispositivo sintetizador MIDI interno especificado. |
midiOutSetVolume | Define o nível de volume do dispositivo sintetizador MIDI interno especificado. |
Nem todos os dispositivos de saída MIDI dão suporte a alterações de volume. Alguns dispositivos podem dar suporte a alterações de volume individuais nos canais esquerdo e direito. Para obter informações sobre como determinar se um dispositivo específico dá suporte a alterações de volume, consulte Consultando dispositivos de saída MIDI.
A menos que seu aplicativo seja projetado para ser um master aplicativo de controle de volume (fornece ao usuário controle de volume para todos os dispositivos de áudio em um sistema), você deve abrir um dispositivo de áudio antes de alterar seu volume. Você também deve marcar o nível de volume antes de alterá-lo e restaurar o nível de volume para o nível anterior o mais rápido possível.
O volume é especificado como um valor de palavra dupla. Os 16 bits superiores especificam o volume relativo do canal direito e os 16 bits inferiores especificam o volume relativo do canal esquerdo.
Para dispositivos que não dão suporte a alterações de volume individuais nos canais esquerdo e direito, os 16 bits inferiores especificam o nível de volume e os 16 bits superiores são ignorados. Os valores para o nível de volume variam de 0x0 (silêncio) a 0xFFFF (volume máximo) e são interpretados logaritmicamente. O aumento de volume percebido é o mesmo ao aumentar o nível de volume de 0x5000 para 0x6000, pois é de 0x4000 para 0x5000.