Estructura MIXERLINEA (mmeapi.h)

La estructura MIXERLINE describe el estado y las métricas de una línea de audio.

Sintaxis

typedef struct tagMIXERLINEA {
  DWORD     cbStruct;
  DWORD     dwDestination;
  DWORD     dwSource;
  DWORD     dwLineID;
  DWORD     fdwLine;
  DWORD_PTR dwUser;
  DWORD     dwComponentType;
  DWORD     cChannels;
  DWORD     cConnections;
  DWORD     cControls;
  CHAR      szShortName[MIXER_SHORT_NAME_CHARS];
  CHAR      szName[MIXER_LONG_NAME_CHARS];
  struct {
    DWORD     dwType;
    DWORD     dwDeviceID;
    WORD      wMid;
    WORD      wPid;
    MMVERSION vDriverVersion;
    CHAR      szPname[MAXPNAMELEN];
  } Target;
} MIXERLINEA, *PMIXERLINEA, *LPMIXERLINEA;

Miembros

cbStruct

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

dwDestination

Índice de línea de destino. Este miembro va de cero a uno menor que el valor especificado en el miembro cDestinations de la estructura MIXERCAPS recuperada por la función mixerGetDevCaps . Cuando se llama a la función mixerGetLineInfo con la marca MIXER_GETLINEINFOF_DESTINATION, se devuelven las propiedades de la línea de destino. (El miembro dwSource debe establecerse en cero en este caso). Cuando se llama con la marca MIXER_GETLINEINFOF_SOURCE, se devuelven las propiedades del origen proporcionado por el miembro dwSource asociado al miembro dwDestination .

dwSource

Índice de la línea de origen de audio asociada al miembro dwDestination . Es decir, este miembro especifica la nªlínea de origen de audio asociada a la línea de destino de audio especificada. Este miembro no se usa para las líneas de destino y debe establecerse en cero cuando se especifica MIXER_GETLINEINFOF_DESTINATION en la función mixerGetLineInfo . Cuando se especifica la marca MIXER_GETLINEINFOF_SOURCE, este miembro va de cero a uno menor que el valor especificado en el miembro cConnections para la línea de destino de audio especificada en el miembro dwDestination .

dwLineID

Identificador definido por el dispositivo mezclador que hace referencia de forma única a la línea de audio descrita por la estructura MIXERLINE . Este identificador es único para cada dispositivo mezclador y puede tener cualquier formato. Una aplicación solo debe usar este identificador como identificador abstracto.

fdwLine

Estado y marcas de compatibilidad para la línea de audio. Este miembro siempre se devuelve a la aplicación y no requiere ninguna inicialización.

Nombre	Descripción
MIXERLINE_LINEF_ACTIVE	La línea de audio está activa. Una línea activa indica que una señal probablemente pase por la línea.
MIXERLINE_LINEF_DISCONNECTED	La línea de audio está desconectada. Todavía se pueden modificar los controles asociados de una línea desconectada, pero los cambios no tienen ningún efecto hasta que se conecta la línea.
MIXERLINE_LINEF_SOURCE	La línea de audio es una línea de origen de audio asociada a una sola línea de destino de audio. Si no se establece esta marca, esta línea es una línea de destino de audio asociada a cero o más líneas de origen de audio.

 

Si una aplicación no usa un dispositivo de salida de audio de forma de onda, la línea de audio asociada a ese dispositivo no estaría activa (es decir, no se establecería la marca MIXERLINE_LINEF_ACTIVE).

Si se abre el dispositivo de salida de audio de forma de onda, la línea de audio se considera activa y se establecerá la marca MIXERLINE_LINEF_ACTIVE.

Un dispositivo de salida de audio de forma de onda pausado o de hambre todavía se considera activo. Es decir, si una aplicación abre el dispositivo de salida de audio de forma de onda, independientemente de si se reproducen datos, la línea de audio asociada se considera activa.

Si una línea no se puede definir estrictamente como activa, el dispositivo mezclador siempre establecerá la marca MIXERLINE_LINEF_ACTIVE.

dwUser

Datos de instancia definidos por el dispositivo de audio para la línea. Este miembro está pensado para aplicaciones mezcladoras personalizadas diseñadas específicamente para que el dispositivo mezclador devuelva esta información. Otras aplicaciones deben omitir estos datos.

dwComponentType

Tipo de componente para esta línea de audio. Una aplicación puede usar esta información para mostrar gráficos personalizados o para buscar un componente determinado. Si una aplicación no usa tipos de componentes, este miembro debe omitirse. Este miembro puede ser uno de los siguientes valores:

Nombre	Descripción
MIXERLINE_COMPONENTTYPE_DST_DIGITAL	La línea de audio es un destino digital (por ejemplo, entrada digital en un dispositivo de audio DAT o CD).
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES	La línea de audio es un destino ajustable (ganancia o atenuación) destinado a conducir auriculares. La mayoría de las tarjetas de audio usan la misma línea de destino de audio para altavoces y auriculares, en cuyo caso el dispositivo mezclador simplemente usa el tipo MIXERLINE_COMPONENTTYPE_DST_SPEAKERS.
MIXERLINE_COMPONENTTYPE_DST_LINE	La línea de audio es un destino de nivel de línea (por ejemplo, entrada de nivel de línea de un dispositivo de audio de CD) que será el origen de grabación final para el convertidor analógico a digital (ADC). Dado que la mayoría de las tarjetas de audio para equipos personales proporcionan algún tipo de ganancia para la línea de origen de audio de grabación, el dispositivo mezclador usará el tipo de MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_MONITOR	La línea de audio es un destino que se usa para un monitor.
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS	La línea de audio es un destino ajustable (ganancia o atenuación) destinado a conducir altavoces. Este es el tipo de componente típico para la salida de audio de tarjetas de audio para equipos personales.
MIXERLINE_COMPONENTTYPE_DST_TELEPHONE	La línea de audio es un destino que se enrutará a una línea telefónica.
MIXERLINE_COMPONENTTYPE_DST_UNDEFINED	La línea de audio es un destino que no se puede definir mediante uno de los tipos de componente estándar. Se requiere un dispositivo mezclador para usar este tipo de componente para los tipos de componentes de línea que microsoft Corporation no ha definido.
MIXERLINE_COMPONENTTYPE_DST_VOICEIN	La línea de audio es un destino que será el origen de grabación final para la entrada de voz. Este tipo de componente es exactamente similar a MIXERLINE_COMPONENTTYPE_DST_WAVEIN, pero está diseñado específicamente para la configuración utilizada durante la grabación o el reconocimiento de voz. La compatibilidad con esta línea es opcional para un dispositivo mezclador. Muchos dispositivos mezclador solo proporcionan MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_WAVEIN	La línea de audio es un destino que será el origen de grabación final para la entrada de audio de forma de onda (ADC). Esta línea suele proporcionar algún tipo de ganancia o atenuación. Este es el tipo de componente típico para la línea de grabación de la mayoría de las tarjetas de audio para equipos personales.
MIXERLINE_COMPONENTTYPE_SRC_ANALOG	La línea de audio es una fuente analógica (por ejemplo, salida analógica de una cinta de cassette de vídeo).
MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY	La línea de audio es un origen que se origina en la línea de audio auxiliar. Este tipo de línea está pensado como un origen con ganancia o atenuación que se puede enrutar al destino de MIXERLINE_COMPONENTTYPE_DST_SPEAKERS o grabar desde el destino de MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC	La línea de audio es un origen que se origina en la salida de un CD de audio interno. Este tipo de componente se proporciona para tarjetas de audio que proporcionan una línea de origen de audio destinada a estar conectada a un CD de audio (o CD-ROM que reproduce un CD de audio).
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL	La línea de audio es un origen digital (por ejemplo, una salida digital de un CD de audio o DAT).
MIXERLINE_COMPONENTTYPE_SRC_LINE	La línea de audio es un origen de nivel de línea (por ejemplo, entrada de nivel de línea de un estéreo externo) que se puede usar como origen de grabación opcional. Dado que la mayoría de las tarjetas de audio para equipos personales proporcionan algún tipo de ganancia para la línea de origen de grabación, el dispositivo mezclador usará el tipo MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY.
MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE	La línea de audio es un origen de grabación de micrófono. La mayoría de las tarjetas de audio para equipos personales proporcionan al menos dos tipos de fuentes de grabación: una línea de audio auxiliar y entrada de micrófono. Normalmente, una línea de audio de micrófono proporciona algún tipo de ganancia. Las tarjetas de audio que usan una sola entrada para su uso con un micrófono o una línea de audio auxiliar deben usar el tipo de componente MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE.
MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER	La línea de audio es una fuente que se origina en el altavoz del equipo personal. Varias tarjetas de audio para equipos personales proporcionan la capacidad de mezclar lo que normalmente se reproduciría en el altavoz interno con la salida de una tarjeta de audio. Algunas tarjetas de audio admiten la capacidad de usar esta salida como origen de grabación.
MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER	La línea de audio es un origen que se origina en la salida de un sintetizador interno. La mayoría de las tarjetas de audio para equipos personales proporcionan algún tipo de sintetizador MIDI.
MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE	La línea de audio es una fuente que se origina en una línea telefónica entrante.
MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED	La línea de audio es un origen que no se puede definir mediante uno de los tipos de componente estándar. Se requiere un dispositivo mezclador para usar este tipo de componente para los tipos de componentes de línea que Microsoft Corporation no ha definido.
MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT	La línea de audio es una fuente que se origina en el convertidor digital a analógico (DAC) de salida de forma de onda. La mayoría de las tarjetas de audio para equipos personales proporcionan este tipo de componente como origen al destino MIXERLINE_COMPONENTTYPE_DST_SPEAKERS. Algunas tarjetas también permiten que este origen se enrute al destino de MIXERLINE_COMPONENTTYPE_DST_WAVEIN.

cChannels

Número máximo de canales independientes que se pueden manipular de forma independiente para la línea de audio. El valor mínimo de este campo es 1 porque una línea debe tener al menos un canal.

La mayoría de las tarjetas de audio modernas para equipos personales son dispositivos estéreo; para ellos, el valor de este miembro es 2.

Se supone que el canal 1 es el canal izquierdo; canal 2 se supone que es el canal correcto.

Una línea multicanal puede tener uno o varios controles uniformes (controles que afectan a todos los canales de una línea uniformemente) asociados a él.

cConnections

Número de conexiones asociadas a la línea de audio. Este miembro solo se usa para las líneas de destino de audio y especifica el número de líneas de origen de audio asociadas a él. Este miembro siempre es cero para las líneas de origen y para las líneas de destino que no tienen ninguna línea de origen de audio asociada a ellas.

cControls

Número de controles asociados a la línea de audio. Este valor puede ser cero. Si no hay controles asociados a la línea, es probable que la línea sea un origen que se pueda seleccionar en un MIXERCONTROL_CONTROLTYPE_MUX o MIXERCONTROL_CONTROLTYPE_MIXER, pero no permite la manipulación de la señal.

szShortName[MIXER_SHORT_NAME_CHARS]

Cadena corta que describe la línea mezcladora de audio especificada en el miembro dwLineID . Esta descripción debe ser adecuada como una etiqueta concisa para la línea.

szName[MIXER_LONG_NAME_CHARS]

Cadena que describe la línea mezcladora de audio especificada en el miembro dwLineID . Esta descripción debe ser adecuada como una descripción completa de la línea.

Target

Información de medios de destino.

Target.dwType

Tipo de dispositivo multimedia de destino asociado a la línea de audio descrita en la estructura MIXERLINE . Una aplicación debe omitir la información de destino de los tipos de dispositivo multimedia que no usa. Se definen los siguientes valores:

Nombre	Descripción
MIXERLINE_TARGETTYPE_AUX	La línea de audio descrita por la estructura MIXERLINE está estrictamente enlazada al dispositivo auxiliar detallado en los miembros restantes de la estructura Target del miembro de estructura MIXERLINE .
MIXERLINE_TARGETTYPE_MIDIIN	La línea de audio descrita por la estructura MIXERLINE está estrictamente enlazada al dispositivo de entrada MIDI detallado en los miembros restantes de la estructura Target de la estructura MIXERLINE .
MIXERLINE_TARGETTYPE_MIDIOUT	La línea de audio descrita por la estructura MIXERLINE está estrictamente enlazada al dispositivo de salida MIDI detallado en los miembros restantes del miembro estructura Target de la estructura MIXERLINE .
MIXERLINE_TARGETTYPE_UNDEFINED	La línea de audio descrita por la estructura MIXERLINE no está estrictamente enlazada a un tipo de medio definido. Se deben omitir todos los miembros restantes de la estructura MIXERLINE . Una aplicación no puede usar el tipo de destino MIXERLINE_TARGETTYPE_UNDEFINED al llamar a la función mixerGetLineInfo con la marca MIXER_GETLINEINFOF_TARGETTYPE.
MIXERLINE_TARGETTYPE_WAVEIN	La línea de audio descrita por la estructura MIXERLINE está estrictamente enlazada al dispositivo de entrada de audio de forma de onda detallado en los miembros restantes de la estructura Target de la estructura MIXERLINE .
MIXERLINE_TARGETTYPE_WAVEOUT	La línea de audio descrita por la estructura MIXERLINE está estrictamente enlazada al dispositivo de salida de audio de forma de onda detallado en los miembros restantes de la estructura Target de la estructura MIXERLINE .

Target.dwDeviceID

Identificador de dispositivo actual del dispositivo multimedia de destino cuando el miembro dwType es un tipo de destino distinto de MIXERLINE_TARGETTYPE_UNDEFINED. Este identificador es idéntico al índice de dispositivo multimedia actual del dispositivo multimedia asociado. Al llamar a la función mixerGetLineInfo con la marca MIXER_GETLINEINFOF_TARGETTYPE, este miembro se omite en la entrada y el administrador del mezclador de audio devolverá al autor de la llamada.

Target.wMid

Identificador de fabricante del dispositivo multimedia de destino cuando el miembro dwType es un tipo de destino distinto de MIXERLINE_TARGETTYPE_UNDEFINED. Este identificador es idéntico al miembro wMid de la estructura de funcionalidades del dispositivo para los medios asociados. Los identificadores de fabricante se definen en Identificadores de fabricante y producto.

Target.wPid

Identificador de producto del dispositivo multimedia de destino cuando el miembro dwType es un tipo de destino distinto de MIXERLINE_TARGETTYPE_UNDEFINED. Este identificador es idéntico al miembro wPid de la estructura device-capabilities del medio asociado. Los identificadores de producto se definen en Fabricante e Identificadores de producto.

Target.vDriverVersion

Versión del controlador del dispositivo multimedia de destino cuando el miembro dwType es un tipo de destino distinto de MIXERLINE_TARGETTYPE_UNDEFINED. Esta versión es idéntica al miembro vDriverVersion de la estructura de funcionalidades del dispositivo para los medios asociados.

Target.szPname[MAXPNAMELEN]

Nombre del producto del dispositivo multimedia de destino cuando el miembro dwType es un tipo de destino distinto de MIXERLINE_TARGETTYPE_UNDEFINED. Este nombre es idéntico al miembro szPname de la estructura device-capabilities del medio asociado.

Comentarios

Nota

El encabezado mmeapi.h define MIXERLINE 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

Requisito	Value
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

MIXERCAPS

mixerGetDevCaps

mixerGetLineInfo