Función Mix_Volume

Sintaxis

int Mix_Volume(int channel, int volume);

Descripción

Ajusta el volumen de un canal específico.

Parámetros

channel

El canal en el que se establece/consulta el volumen, o -1 para todos los canales.

volume

El nuevo volumen, entre 0 y MIX_MAX_VOLUME, o -1 para consultar.

Valor de retorno

Devuelve el volumen anterior. Si el volumen especificado es -1, devuelve el volumen actual. Si el canal es -1, devuelve la media de todos los canales.

Observaciones

El volumen debe estar entre 0 (silencio) y MIX_MAX_VOLUME (volumen máximo). Hay que tener en cuenta que MIX_MAX_VOLUME es 128. Los valores superiores a MIX_MAX_VOLUME se ajustan a MIX_MAX_VOLUME.

Especificar un volumen negativo no cambiará el volumen actual; como tal, esto se puede utilizar para consultar el volumen actual sin hacer cambios, ya que esta función devuelve el valor anterior (en este caso, todavía actual).

Si el canal especificado es -1, esta función establece el volumen para todos los canales, y devuelve la media de los volúmenes de todos los canales antes de esta llamada.

El volumen por defecto para un canal es MIX_MAX_VOLUME (sin atenuación).