Estructura MIXERLINECONTROLSW (mmeapi.h)

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

Sintaxis

typedef struct tagMIXERLINECONTROLSW {
  DWORD           cbStruct;
  DWORD           dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  } DUMMYUNIONNAME;
  DWORD           cControls;
  DWORD           cbmxctrl;
  LPMIXERCONTROLW pamxctrl;
} MIXERLINECONTROLSW, *PMIXERLINECONTROLSW, *LPMIXERLINECONTROLSW;

Members

cbStruct

Tamaño, en bytes, de la estructura MIXERLINECONTROLS . Este miembro debe inicializarse antes de llamar a la función mixerGetLineControls . El tamaño especificado en este miembro debe ser lo suficientemente grande como para contener la estructura MIXERLINECONTROLS . Cuando se devuelve mixerGetLineControls , 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 .

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 miembros dwControlID y 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 mixerGetLineControls para recuperar la información de control del control especificado. Tenga en cuenta que el dispositivo mezclador devolverá el miembro dwLineID de la estructura MIXERLINECONTROLS 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 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 de la estructura MIXERLINECONTROLS . Este miembro se superpone con el miembro dwControlID y no se puede usar junto con el tipo de consulta MIXER_GETLINECONTROLSF_ONEBYID. Consulte la descripción del miembro dwControlType en MIXERCONTROL.

cControls

Número de elementos de estructura MIXERCONTROL 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 cControls de la estructura MIXERLINE 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 única estructura MIXERCONTROL . El tamaño especificado en este miembro debe ser lo suficientemente grande como 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 los miembros cbmxctrl y cControls de la estructura MIXERLINECONTROLS .

pamxctrl

Puntero a una o varias estructuras MIXERCONTROL para recibir las propiedades de los controles de línea de audio solicitados. Este miembro no puede ser NULL y debe inicializarse antes de llamar a la función mixerGetLineControls . 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 miembro cbStruct de cada estructura MIXERCONTROL ) al devolverse correctamente.

Comentarios

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 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]
Encabezado	mmeapi.h

Consulte también

Estructuras de mezclador de audio

Mezcladores de audio

MIXERCONTROL

MIXERLINE

mixerGetLineControls