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 |
|---|---|
|
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 |