Estructura MIXERLINECONTROLSA (mmeapi.h)

La estructura de MIXERLINECONTROLS contiene información sobre los controles de una línea de audio.

Sintaxis

typedef struct tagMIXERLINECONTROLSA {
  DWORD           cbStruct;
  DWORD           dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  } DUMMYUNIONNAME;
  DWORD           cControls;
  DWORD           cbmxctrl;
  LPMIXERCONTROLA pamxctrl;
} MIXERLINECONTROLSA, *PMIXERLINECONTROLSA, *LPMIXERLINECONTROLSA;

Miembros

cbStruct

Tamaño, en bytes, de la estructura MIXERLINECONTROLS de . Este miembro debe inicializarse antes de llamar a la función mezclador mixerGetLineControls. El tamaño especificado en este miembro debe ser lo suficientemente grande como para contener la estructura MIXERLINECONTROLS. Cuando mixerGetLineControls devuelve, este miembro contiene el tamaño real de la información devuelta. La información devuelta no superará el tamaño solicitado, ni será menor que la estructura MIXERLINECONTROLS de .

dwLineID

Identificador de línea para el que se consultan los controles. Este miembro no se usa si se especifica la marca MIXER_GETLINECONTROLSF_ONEBYID para la función mixerGetLineControls, pero el dispositivo mezclador sigue devuelve este miembro en este caso. Los dwControlID y miembros dwControlType no se usan cuando se especifica MIXER_GETLINECONTROLSF_ALL.

DUMMYUNIONNAME

DUMMYUNIONNAME.dwControlID

Identificador de control del control deseado. Este miembro se usa con la marca MIXER_GETLINECONTROLSF_ONEBYID para la función de mixerGetLineControls para recuperar la información de control del control especificado. Tenga en cuenta que el miembro dwLineID del MIXERLINECONTROLS estructura será devuelto por el dispositivo mezclador y no es necesario como parámetro de entrada. Este miembro se superpone con el miembro dwControlType y no se puede usar junto con el tipo de consulta MIXER_GETLINECONTROLSF_ONEBYTYPE.

DUMMYUNIONNAME.dwControlType

Clase de los tipos de control de deseados. Este miembro se usa con la marca MIXER_GETLINECONTROLSF_ONEBYTYPE para la función mixerGetLineControls para recuperar el primer control de la clase especificada en la línea especificada por el miembro dwLineID del MIXERLINECONTROLS estructura. Este miembro se superpone con el miembro dwControlID y no se puede usar junto con el tipo de consulta MIXER_GETLINECONTROLSF_ONEBYID. Vea la descripción del miembro dwControlType en MIXERCONTROL.

cControls

Número de MIXERCONTROL elementos de estructura que se van a recuperar. La aplicación debe inicializar este miembro antes de llamar a la función mixerGetLineControls . Este miembro solo puede ser 1 si se especifica MIXER_GETLINECONTROLSF_ONEBYID o MIXER_GETLINECONTROLSF_ONEBYTYPE o el valor devuelto en el miembro de cControls del MIXERLINE estructura devuelta para una línea de audio. Este miembro no puede ser cero. Si una línea de audio especifica que no tiene controles, no se debe llamar a mixerGetLineControls.

cbmxctrl

Tamaño, en bytes, de una sola estructura MIXERCONTROL. El tamaño especificado en este miembro debe ser lo suficientemente grande como mínimo para contener la estructura MIXERCONTROL base. El tamaño total, en bytes, necesario para el búfer al que apunta el miembro pamxctrl es el producto de la cbmxctrl y cControls miembros de la estructura MIXERLINECONTROLS.

pamxctrl

Puntero a una o varias estructuras de MIXERCONTROL para recibir las propiedades de los controles de línea de audio solicitados. Este miembro no se puede NULL y debe inicializarse antes de llamar a la función mezclador . Cada elemento de la matriz de controles debe ser lo suficientemente grande como mínimo para contener una estructura MIXERCONTROL base. El miembro cbmxctrl debe especificar el tamaño, en bytes, de cada elemento de esta matriz. La aplicación no requiere ninguna inicialización del búfer al que apunta este miembro. Todos los miembros se rellenan mediante el dispositivo mezclador (incluido el cbStruct miembro de cada MIXERCONTROL estructura) al devolverse correctamente.

Observaciones

Nota

El encabezado mmeapi.h define MIXERLINECONTROLS 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]
encabezado de	mmeapi.h

Consulte también

estructuras de mezclador de audio

mezcladores de audio de

MIXERCONTROL

MIXERLINE

mezcladorGetLineControls