Función mixerGetLineControlsA (mmeapi.h)

Artículo
11/20/2024

La función mixerGetLineControls recupera uno o varios controles asociados a una línea de audio.

Sintaxis

MMRESULT mixerGetLineControlsA(
  HMIXEROBJ            hmxobj,
  LPMIXERLINECONTROLSA pmxlc,
  DWORD                fdwControls
);

Parámetros

hmxobj

Identificador del objeto de dispositivo mezclador que se está consultando.

pmxlc

Puntero a una estructura de MIXERLINECONTROLS. Esta estructura se usa para hacer referencia a una o varias estructuras de MIXERCONTROL que se rellenarán con información sobre los controles asociados a una línea de audio. El cbStruct miembro de la estructura MIXERLINECONTROLS debe inicializarse siempre para que sea el tamaño, en bytes, de la estructura de MIXERLINECONTROLS.

fdwControls

Marcas para recuperar información sobre uno o varios controles asociados a una línea de audio. Se definen los siguientes valores.

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 dwLineID miembro del MIXERLINECONTROLS estructura. 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 de MIXERLINE devuelta por la función mixerGetLineInfo. El miembro cbmxctrl debe inicializarse en el tamaño, en bytes, de una sola estructura MIXERCONTROL. El miembro pamxctrl debe apuntar a la primera estructura MIXERCONTROL que se va a rellenar. Los dwControlID de y dwControlType miembros 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 dwControlID miembro del MIXERLINECONTROLS estructura. El miembro cControls debe inicializarse en 1. El miembro cbmxctrl debe inicializarse en el tamaño, en bytes, de una sola estructura MIXERCONTROL. El miembro pamxctrl de debe apuntar a una estructura de MIXERCONTROL que se va a rellenar. Los dwLineID y miembros 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 mezcladorAbrir).
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 controlador de un dispositivo de entrada MIDI. La función midiInOpen debe haber devuelto este identificador.
MIXER_OBJECTF_HMIDIOUT	El parámetro hmxobj es el controlador 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 controlador de entrada de audio de forma de onda devuelto por la función waveInOpen.
MIXER_OBJECTF_HWAVEOUT	El parámetro hmxobj es un controlador 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 ejecuta correctamente o si se produce un error. Entre los posibles valores de error se incluyen los siguientes.

Código devuelto	Descripción
MIXERR_INVALCONTROL	La referencia de control no es válida.
MIXERR_INVALLINE	La referencia de la línea de audio no es válida.
MMSYSERR_BADDEVICEID	El parámetro hmxobj especifica un identificador de dispositivo no válido.
MMSYSERR_INVALFLAG	Una o varias marcas no son válidas.
MMSYSERR_INVALHANDLE	El parámetro hmxobj especifica un identificador no válido.
MMSYSERR_INVALPARAM	Uno o varios parámetros no son válidos.
MMSYSERR_NODRIVER	No hay ningún dispositivo mezclador disponible para el objeto especificado por hmxobj.

Observaciones

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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	mmeapi.h (incluya Windows.h)
biblioteca de	Winmm.lib
DLL de	Winmm.dll

Consulte también

funciones de mezclador de audio de

mezcladores de audio de

Compartir a través de