Función mixerGetLineControls (mmeapi.h)

Artículo
08/24/2023

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

Sintaxis

MMRESULT mixerGetLineControls(
  HMIXEROBJ           hmxobj,
  LPMIXERLINECONTROLS 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
MIXERR_INVALCONTROL	La referencia de control no es válida.
MIXERR_INVALLINE	La referencia de 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.

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

Consulte también

Funciones de mezclador de audio

Mezcladores de audio

Compartir a través de