Función mixerGetLineInfoA (mmeapi.h)

La función mixerGetLineInfo recupera información sobre una línea específica de un dispositivo mezclador.

Sintaxis

MMRESULT mixerGetLineInfoA(
  HMIXEROBJ    hmxobj,
  LPMIXERLINEA pmxl,
  DWORD        fdwInfo
);

Parámetros

hmxobj

Controla el objeto de dispositivo mezclador que controla la línea de audio específica.

pmxl

Puntero a una estructura de MIXERLINE. Esta estructura se rellena con información sobre la línea de audio del dispositivo mezclador. El miembro cbStruct siempre debe inicializarse para que sea el tamaño, en bytes, de la estructura MIXERLINE de .

fdwInfo

Marcas para recuperar información sobre una línea de audio. Se definen los siguientes valores.

Valor	Significado
MIXER_GETLINEINFOF_COMPONENTTYPE	El parámetro pmxl recibirá información sobre la primera línea de audio del tipo especificado en el miembro dwComponentType de la estructura de MIXERLINE. Esta marca se usa para recuperar información sobre una línea de audio de un tipo de componente específico. Los miembros de estructura restantes excepto cbStruct no requieren ninguna inicialización adicional.
MIXER_GETLINEINFOF_DESTINATION	El parámetro pmxl de recibirá información sobre la línea de audio de destino especificada por el miembro dwDestination de la estructura MIXERLINE de . Este índice oscila entre cero y uno menor que el valor de la cDestinations miembro de la estructura de MIXERCAPS. Todos los miembros de estructura restantes, excepto cbStruct no requieren ninguna inicialización adicional.
MIXER_GETLINEINFOF_LINEID	El parámetro pmxl recibirá información sobre la línea de audio especificada por el miembro dwLineID de la estructura de MIXERLINE. Normalmente se usa para recuperar información actualizada sobre el estado de una línea de audio. Todos los miembros de estructura restantes, excepto cbStruct no requieren ninguna inicialización adicional.
MIXER_GETLINEINFOF_SOURCE	El parámetro pmxl recibirá información sobre la línea de audio de origen especificada por el de dwDestination y dwSource miembros de la estructura MIXERLINE. El índice especificado por dwDestination intervalos de cero a uno menor que el valor de la cDestinations miembro del MIXERCAPS estructura. El índice especificado por dwSource intervalos de cero a uno menor que el valor del miembro cConnections del MIXERLINE devuelto para la línea de audio almacenada en el miembro dwDestination de . Todos los miembros de estructura restantes, excepto cbStruct no requieren ninguna inicialización adicional.
MIXER_GETLINEINFOF_TARGETTYPE	El parámetro pmxl recibirá información sobre la línea de audio que es para el miembro dwType del estructura target, que es miembro de la estructura MIXERLINE de . Esta marca se usa para recuperar información sobre una línea de audio que controla el tipo de destino (por ejemplo, MIXERLINE_TARGETTYPE_WAVEOUT). La aplicación debe inicializar el dwType, wMid, wPid, vDriverVersion y szPname miembros de la estructura MIXERLINE antes de llamar a mixerGetLineInfo. Todos estos valores se pueden recuperar de las estructuras de funcionalidades del dispositivo para todos los dispositivos multimedia. Los miembros de estructura restantes excepto cbStruct no requieren ninguna inicialización adicional. Nota En la versión ANSI de esta función (mixerGetLineInfoA), no puede usar la cadena ANSI devuelta desde mixerGetLineInfo o waveOutGetDevCaps para el valor de la cadena psPname al llamar a mixerGetLineInfo con la marca MIXER_GETLINEINFOF_TARGETTYPE. El motivo es que se realiza una conversión interna hacia y desde Unicode, lo que podría dar lugar a la pérdida de datos.
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 un identificador de 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_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 mixerGetLineInfo 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