Función mixerGetLineControlsW (mmeapi.h)
La función mixerGetLineControls recupera uno o varios controles asociados a una línea de audio.
Sintaxis
MMRESULT mixerGetLineControlsW(
HMIXEROBJ hmxobj,
LPMIXERLINECONTROLSW pmxlc,
DWORD fdwControls
);
Parámetros
hmxobj
Identificador del objeto de dispositivo mezclador que se está consultando.
pmxlc
Puntero a una estructura MIXERLINECONTROLS . Esta estructura se usa para hacer referencia a una o varias estructuras MIXERCONTROL que se rellenarán con información sobre los controles asociados a una línea de audio. El miembro cbStruct de la estructura MIXERLINECONTROLS siempre debe inicializarse para que sea el tamaño, en bytes, de la estructura MIXERLINECONTROLS .
fdwControls
Marcas para recuperar información sobre uno o varios controles asociados a una línea de audio. Se definen los valores siguientes.
| Valor | Significado |
|---|---|
| MIXER_GETLINECONTROLSF_ALL | El parámetro pmxlc hace referencia a una lista de estructuras MIXERCONTROL que recibirán información sobre todos los controles asociados a la línea de audio identificada por el miembro dwLineID de la estructura MIXERLINECONTROLS . El miembro cControls debe inicializarse en el número de controles asociados a la línea. Este número se recupera del miembro cControls de la estructura MIXERLINE devuelta por la función mixerGetLineInfo . El miembro cbmxctrl debe inicializarse en el tamaño, en bytes, de una única estructura MIXERCONTROL . El miembro pamxctrl debe apuntar a la primera estructura MIXERCONTROL que se va a rellenar. Los miembros dwControlID y dwControlType se omiten para esta consulta. |
| MIXER_GETLINECONTROLSF_ONEBYID | El parámetro pmxlc hace referencia a una única estructura MIXERCONTROL que recibirá información sobre el control identificado por el miembro dwControlID de la estructura MIXERLINECONTROLS . El miembro cControls debe inicializarse en 1. El miembro cbmxctrl debe inicializarse en el tamaño, en bytes, de una única estructura MIXERCONTROL . El miembro pamxctrl debe apuntar a una estructura MIXERCONTROL que se va a rellenar. Los miembros dwLineID y dwControlType se omiten para esta consulta. Normalmente, esta consulta se usa para actualizar un control después de recibir un mensaje de notificación de cambio de control de MM_MIXM_CONTROL_CHANGE mediante la devolución de llamada definida por el usuario (consulte mixerOpen). |
| MIXER_GETLINECONTROLSF_ONEBYTYPE | La función mixerGetLineControls recupera información sobre el primer control de una clase específica para la línea de audio que se está consultando. El parámetro pmxlc hace referencia a una única estructura MIXERCONTROL que recibirá información sobre el control específico. La línea de audio se identifica mediante el miembro dwLineID . La clase de control se especifica en el miembro dwControlType de la estructura MIXERLINECONTROLS . El miembro dwControlID se omite para esta consulta. Una aplicación puede usar esta consulta para obtener información sobre un único control asociado a una línea. Por ejemplo, es posible que quiera que la aplicación use un medidor máximo solo desde una línea de salida de audio de forma de onda. |
| MIXER_OBJECTF_AUX | El parámetro hmxobj es un identificador de dispositivo auxiliar en el intervalo de cero a uno menor que el número de dispositivos devueltos por la función auxGetNumDevs . |
| MIXER_OBJECTF_HMIDIIN | El parámetro hmxobj es el identificador de un dispositivo de entrada MIDI. La función midiInOpen debe haber devuelto este identificador. |
| MIXER_OBJECTF_HMIDIOUT | El parámetro hmxobj es el identificador de un dispositivo de salida MIDI. La función midiOutOpen debe haber devuelto este identificador. |
| MIXER_OBJECTF_HMIXER | El parámetro hmxobj es un identificador de dispositivo mezclador devuelto por la función mixerOpen . Esta marca es opcional. |
| MIXER_OBJECTF_HWAVEIN | El parámetro hmxobj es un identificador de entrada de forma de onda devuelto por la función waveInOpen . |
| MIXER_OBJECTF_HWAVEOUT | El parámetro hmxobj es un identificador de salida de audio de forma de onda devuelto por la función waveOutOpen . |
| MIXER_OBJECTF_MIDIIN | El parámetro hmxobj es el identificador de un dispositivo de entrada MIDI. Este identificador debe estar en el intervalo de cero a uno menor que el número de dispositivos devueltos por la función midiInGetNumDevs . |
| MIXER_OBJECTF_MIDIOUT | El parámetro hmxobj es el identificador de un dispositivo de salida MIDI. Este identificador debe estar en el intervalo de cero a uno menor que el número de dispositivos devueltos por la función midiOutGetNumDevs . |
| MIXER_OBJECTF_MIXER | El parámetro hmxobj es el identificador de un dispositivo mezclador en el intervalo de cero a uno menor que el número de dispositivos devueltos por la función mixerGetNumDevs . Esta marca es opcional. |
| MIXER_OBJECTF_WAVEIN | El parámetro hmxobj es el identificador de un dispositivo de entrada de audio de forma de onda en el intervalo de cero a uno menor que el número de dispositivos devueltos por la función waveInGetNumDevs . |
| MIXER_OBJECTF_WAVEOUT | El parámetro hmxobj es el identificador de un dispositivo de salida de audio de forma de onda en el intervalo de cero a uno menor que el número de dispositivos devueltos por la función waveOutGetNumDevs . |
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 |
|---|---|
|
La referencia de control no es válida. |
|
La referencia de línea de audio no es válida. |
|
El parámetro hmxobj especifica un identificador de dispositivo no válido. |
|
Una o varias marcas no son válidas. |
|
El parámetro hmxobj especifica un identificador no válido. |
|
Uno o varios parámetros no son válidos. |
|
No hay ningún dispositivo mezclador disponible para el objeto especificado por hmxobj. |
Comentarios
Nota:
El encabezado mmeapi.h define mixerGetLineControls como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| 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 |