Estructura MIXERLINEW (mmeapi.h)

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

Sintaxis

typedef struct tagMIXERLINEW {
  DWORD     cbStruct;
  DWORD     dwDestination;
  DWORD     dwSource;
  DWORD     dwLineID;
  DWORD     fdwLine;
  DWORD_PTR dwUser;
  DWORD     dwComponentType;
  DWORD     cChannels;
  DWORD     cConnections;
  DWORD     cControls;
  WCHAR     szShortName[MIXER_SHORT_NAME_CHARS];
  WCHAR     szName[MIXER_LONG_NAME_CHARS];
  struct {
    DWORD     dwType;
    DWORD     dwDeviceID;
    WORD      wMid;
    WORD      wPid;
    MMVERSION vDriverVersion;
    WCHAR     szPname[MAXPNAMELEN];
  } Target;
} MIXERLINEW, *PMIXERLINEW, *LPMIXERLINEW;

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 a 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 debe usar este identificador solo 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 es probable que una señal pase por la línea.
MIXERLINE_LINEF_DISCONNECTED	La línea de audio está desconectada. Los controles asociados de una línea desconectada todavía se pueden modificar, pero los cambios no tienen ningún efecto hasta que la línea está conectada.
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 con 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. En otras palabras, si un dispositivo de salida de audio de forma de onda se abre mediante una aplicación 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á diseñado para aplicaciones de mezclador 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, se debe omitir este miembro. 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 a 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 desde un dispositivo de audio 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 impulsar 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 final de la grabación 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 final de la grabación 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 video-cassette).
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 se puede registrar 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 las tarjetas de audio que proporcionan una línea de origen de audio diseñada para conectarse 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 daT o audio).
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 un origen 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 de MIXERLINE_COMPONENTTYPE_DST_SPEAKERS. Algunas tarjetas también permiten enrutar este origen 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; channel 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.

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 valores siguientes:

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 del miembro de estructura Target de la 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 del miembro de 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 de 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 del miembro de 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 del miembro 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 de funcionalidades del dispositivo para los medios asociados. 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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