Función auxSetVolume (mmeapi.h)

La función auxSetVolume establece el volumen del dispositivo de salida auxiliar especificado.

Sintaxis

MMRESULT auxSetVolume(
  UINT  uDeviceID,
  DWORD dwVolume
);

Parámetros

uDeviceID

Identificador del dispositivo de salida auxiliar que se va a consultar. Los identificadores de dispositivo se determinan implícitamente del número de dispositivos presentes en el sistema. Los valores de identificador de dispositivo van de cero a uno menor que el número de dispositivos presentes. Use la función auxGetNumDevs para determinar el número de dispositivos auxiliares del sistema.

dwVolume

Especifica la nueva configuración de volumen. La palabra de orden bajo especifica la configuración del volumen del canal izquierdo y la palabra de orden superior especifica la configuración del canal derecho. Un valor de 0xFFFF representa el volumen completo y un valor de 0x0000 es silencio.

Si un dispositivo no admite el control de volumen izquierdo y derecho, la palabra de orden bajo de dwVolume especifica el nivel de volumen y se omite la palabra de orden superior.

Valor devuelto

Devuelve MMSYSERR_NOERROR si se realiza correctamente o si se produce un error en caso contrario. Entre los valores de error posibles se incluyen los siguientes.

Código devuelto	Descripción
MMSYSERR_BADDEVICEID	El identificador de dispositivo especificado está fuera del intervalo.

Comentarios

No todos los dispositivos admiten el control de volumen. Para determinar si el dispositivo admite el control de volumen, use la marca AUXCAPS_VOLUME para probar el miembro dwSupport de la estructura AUXCAPS (rellenado por la función auxGetDevCaps ).

Para determinar si el dispositivo admite el control de volumen en los canales izquierdo y derecho, use la marca AUXCAPS_LRVOLUME para probar el miembro dwSupport de la estructura AUXCAPS (rellenado por auxGetDevCaps).

La mayoría de los dispositivos no admiten los 16 bits completos del control de nivel de volumen y solo usarán los bits de orden superior de la configuración de volumen solicitada. Por ejemplo, para un dispositivo que admite 4 bits de control de volumen, los valores de nivel de volumen solicitados de 0x4000, 0x4FFF y 0x43BE producirán la misma configuración de volumen físico, 0x4000. La función auxGetVolume devolverá el valor completo de 16 bits establecido con auxSetVolume.

La configuración del volumen se interpreta logarítmicamente. Esto significa que el aumento de volumen percibido es el mismo al aumentar el nivel de volumen de 0x5000 a 0x6000, ya que es de 0x4000 a 0x5000.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mmeapi.h (incluya Windows.h)
Library	Winmm.lib
Archivo DLL	Winmm.dll

Consulte también

Audio de forma de onda

Funciones de forma de onda