Función auxGetVolume (mmeapi.h)

La función auxGetVolume recupera la configuración de volumen actual del dispositivo de salida auxiliar especificado.

Sintaxis

MMRESULT auxGetVolume(
  UINT    uDeviceID,
  LPDWORD pdwVolume
);

Parámetros

uDeviceID

Identificador del dispositivo de salida auxiliar que se va a consultar.

pdwVolume

Puntero a una variable que se va a rellenar con la configuración del volumen actual. La palabra de orden bajo de esta ubicación contiene la configuración del volumen del canal izquierdo y la palabra de orden superior contiene 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 inferior de la ubicación especificada contiene el nivel de volumen.

Se devuelven los valores completos de 16 bits con la función auxSetVolume , independientemente de si el dispositivo admite los 16 bits completos del control de nivel de volumen.

Valor devuelto

Devuelve MMSYSERR_NOERROR si se ejecuta correctamente o si se produce un error. Entre los posibles valores de error 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 un 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 un 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).

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 (incluye Windows.h)
Library	Winmm.lib
Archivo DLL	Winmm.dll

Consulte también

Audio de forma de onda

Funciones de forma de onda