Estrutura MIXERLINEW (mmeapi.h)

A estrutura MIXERLINE descreve o estado e as métricas de uma linha de áudio.

Sintaxe

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;

Membros

cbStruct

Tamanho, em bytes, da estrutura MIXERLINE . Esse membro deve ser inicializado antes de chamar a função mixerGetLineInfo . O tamanho especificado neste membro deve ser grande o suficiente para conter a estrutura MIXERLINE . Quando mixerGetLineInfo retorna, esse membro contém o tamanho real das informações retornadas. As informações retornadas não excederão o tamanho solicitado.

dwDestination

Índice de linha de destino. Esse membro varia de zero a um a menos do que o valor especificado no membro cDestinations da estrutura MIXERCAPS recuperada pela função mixerGetDevCaps . Quando a função mixerGetLineInfo é chamada com o sinalizador MIXER_GETLINEINFOF_DESTINATION, as propriedades da linha de destino são retornadas. (O membro dwSource deve ser definido como zero nesse caso.) Quando chamado com o sinalizador MIXER_GETLINEINFOF_SOURCE, as propriedades para a origem fornecidas pelo membro dwSource associado ao membro dwDestination são retornadas.

dwSource

Índice para a linha de origem de áudio associada ao membro dwDestination . Ou seja, esse membro especifica a nªlinha de origem de áudio associada à linha de destino de áudio especificada. Esse membro não é usado para linhas de destino e deve ser definido como zero quando MIXER_GETLINEINFOF_DESTINATION é especificado na função mixerGetLineInfo . Quando o sinalizador MIXER_GETLINEINFOF_SOURCE é especificado, esse membro varia de zero a um a menos do que o valor especificado no membro cConnections para a linha de destino de áudio fornecida no membro dwDestination .

dwLineID

Um identificador definido pelo dispositivo de mixer que se refere exclusivamente à linha de áudio descrita pela estrutura MIXERLINE . Esse identificador é exclusivo para cada dispositivo de mixer e pode estar em qualquer formato. Um aplicativo deve usar esse identificador apenas como um identificador abstrato.

fdwLine

Sinalizadores de status e suporte para a linha de áudio. Esse membro sempre é retornado ao aplicativo e não requer nenhuma inicialização.

Nome	Descrição
MIXERLINE_LINEF_ACTIVE	A linha de áudio está ativa. Uma linha ativa indica que um sinal provavelmente está passando pela linha.
MIXERLINE_LINEF_DISCONNECTED	A linha de áudio está desconectada. Os controles associados de uma linha desconectada ainda podem ser modificados, mas as alterações não têm efeito até que a linha seja conectada.
MIXERLINE_LINEF_SOURCE	A linha de áudio é uma linha de origem de áudio associada a uma única linha de destino de áudio. Se esse sinalizador não estiver definido, essa linha será uma linha de destino de áudio associada a zero ou mais linhas de origem de áudio.

 

Se um aplicativo não estiver usando um dispositivo de saída waveform-audio, a linha de áudio associada a esse dispositivo não estará ativa (ou seja, o sinalizador MIXERLINE_LINEF_ACTIVE não seria definido).

Se o dispositivo de saída waveform-audio for aberto, a linha de áudio será considerada ativa e o sinalizador MIXERLINE_LINEF_ACTIVE será definido.

Um dispositivo de saída de áudio de forma de onda pausado ou faminto ainda é considerado ativo. Em outras palavras, se o dispositivo de saída waveform-audio for aberto por um aplicativo, independentemente de os dados estarem sendo reproduzidos, a linha de áudio associada será considerada ativa.

Se uma linha não puder ser estritamente definida como ativa, o dispositivo de mixer sempre definirá o sinalizador MIXERLINE_LINEF_ACTIVE.

dwUser

Dados de instância definidos pelo dispositivo de áudio para a linha. Esse membro destina-se a aplicativos de mixer personalizados projetados especificamente para o dispositivo de mixer que retorna essas informações. Outros aplicativos devem ignorar esses dados.

dwComponentType

Tipo de componente para esta linha de áudio. Um aplicativo pode usar essas informações para exibir gráficos personalizados ou pesquisar um componente específico. Se um aplicativo não usar tipos de componente, esse membro deverá ser ignorado. Esse membro pode ser um dos seguintes valores:

Nome	Descrição
MIXERLINE_COMPONENTTYPE_DST_DIGITAL	A linha de áudio é um destino digital (por exemplo, entrada digital para um dispositivo de áudio DAT ou CD).
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES	A linha de áudio é um destino ajustável (ganho e/ou atenuação) destinado à unidade de fones de ouvido. A maioria dos cartões de áudio usa a mesma linha de destino de áudio para alto-falantes e fones de ouvido. Nesse caso, o dispositivo de mixer simplesmente usa o tipo MIXERLINE_COMPONENTTYPE_DST_SPEAKERS.
MIXERLINE_COMPONENTTYPE_DST_LINE	A linha de áudio é um destino de nível de linha (por exemplo, entrada de nível de linha de um dispositivo de áudio cd) que será a fonte de gravação final para o conversor analógico para digital (ADC). Como a maioria dos cartões de áudio para computadores pessoais proporciona algum tipo de ganho para a linha de origem de áudio de gravação, o dispositivo de mixer usará o tipo MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_MONITOR	A linha de áudio é um destino usado para um monitor.
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS	A linha de áudio é um destino ajustável (ganho e/ou atenuação) destinado a alto-falantes de unidade. Esse é o tipo de componente típico para a saída de áudio de cartões de áudio para computadores pessoais.
MIXERLINE_COMPONENTTYPE_DST_TELEPHONE	A linha de áudio é um destino que será roteado para uma linha telefônica.
MIXERLINE_COMPONENTTYPE_DST_UNDEFINED	A linha de áudio é um destino que não pode ser definido por um dos tipos de componente padrão. Um dispositivo de mixer é necessário para usar esse tipo de componente para tipos de componente de linha que não foram definidos pela Microsoft Corporation.
MIXERLINE_COMPONENTTYPE_DST_VOICEIN	A linha de áudio é um destino que será a fonte de gravação final para entrada de voz. Esse tipo de componente é exatamente como MIXERLINE_COMPONENTTYPE_DST_WAVEIN, mas destina-se especificamente às configurações usadas durante a gravação/reconhecimento de voz. O suporte para essa linha é opcional para um dispositivo de mixer. Muitos dispositivos de mixer fornecem apenas MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_WAVEIN	A linha de áudio é um destino que será a fonte de gravação final para a ADC (entrada de áudio de forma de onda). Essa linha normalmente fornece algum tipo de ganho ou atenuação. Esse é o tipo de componente típico para a linha de gravação da maioria dos cartões de áudio para computadores pessoais.
MIXERLINE_COMPONENTTYPE_SRC_ANALOG	A linha de áudio é uma fonte analógica (por exemplo, saída analógica de uma fita cassete de vídeo).
MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY	A linha de áudio é uma origem originária da linha de áudio auxiliar. Esse tipo de linha destina-se como uma origem com ganho ou atenuação que pode ser roteada para o destino MIXERLINE_COMPONENTTYPE_DST_SPEAKERS e/ou registrada do destino MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC	A linha de áudio é uma origem originária da saída de um CD de áudio interno. Esse tipo de componente é fornecido para cartões de áudio que fornecem uma linha de origem de áudio destinada a ser conectada a um CD de áudio (ou CD-ROM reproduzindo um CD de áudio).
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL	A linha de áudio é uma fonte digital (por exemplo, saída digital de um DAT ou CD de áudio).
MIXERLINE_COMPONENTTYPE_SRC_LINE	A linha de áudio é uma fonte de nível de linha (por exemplo, entrada de nível de linha de um estéreo externo) que pode ser usada como uma fonte de gravação opcional. Como a maioria dos cartões de áudio para computadores pessoais proporciona algum tipo de ganho para a linha de origem da gravação, o dispositivo de mixer usará o tipo MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY.
MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE	A linha de áudio é uma fonte de gravação de microfone. A maioria dos cartões de áudio para computadores pessoais fornece pelo menos dois tipos de fontes de gravação: uma entrada auxiliar de linha de áudio e microfone. Uma linha de áudio de microfone normalmente fornece algum tipo de ganho. As placas de áudio que usam uma única entrada para uso com um microfone ou uma linha de áudio auxiliar devem usar o tipo de componente MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE.
MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER	A linha de áudio é uma origem originária do alto-falante do computador pessoal. Várias placas de áudio para computadores pessoais fornecem a capacidade de misturar o que normalmente seria reproduzido no alto-falante interno com a saída de uma cartão de áudio. Algumas placas de áudio dão suporte à capacidade de usar essa saída como fonte de gravação.
MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER	A linha de áudio é uma origem originária da saída de um sintetizador interno. A maioria dos cartões de áudio para computadores pessoais fornece algum tipo de sintetizador MIDI.
MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE	A linha de áudio é uma origem originária de uma linha telefônica de entrada.
MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED	A linha de áudio é uma origem que não pode ser definida por um dos tipos de componente padrão. Um dispositivo de mixer é necessário para usar esse tipo de componente para tipos de componente de linha que não foram definidos pela Microsoft Corporation.
MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT	A linha de áudio é uma origem originária do DAC (conversor digital para analógico) de saída de forma de onda. A maioria dos cartões de áudio para computadores pessoais fornece esse tipo de componente como uma origem para o destino MIXERLINE_COMPONENTTYPE_DST_SPEAKERS. Alguns cartões também permitem que essa origem seja roteada para o destino MIXERLINE_COMPONENTTYPE_DST_WAVEIN.

cChannels

Número máximo de canais separados que podem ser manipulados independentemente para a linha de áudio. O valor mínimo para esse campo é 1 porque uma linha deve ter pelo menos um canal.

A maioria dos cartões de áudio modernos para computadores pessoais são dispositivos estéreo; para eles, o valor desse membro é 2.

Supõe-se que o Canal 1 seja o canal esquerdo; O canal 2 é considerado o canal certo.

Uma linha multicanal pode ter um ou mais controles uniformes (controles que afetam todos os canais de uma linha uniformemente) associados a ela.

cConnections

Número de conexões associadas à linha de áudio. Esse membro é usado apenas para linhas de destino de áudio e especifica o número de linhas de origem de áudio associadas a ele. Esse membro é sempre zero para linhas de origem e para linhas de destino que não têm nenhuma linha de origem de áudio associada a elas.

cControls

Número de controles associados à linha de áudio. Esse valor pode ser zero. Se nenhum controle estiver associado à linha, é provável que a linha seja uma origem que possa ser selecionada em um MIXERCONTROL_CONTROLTYPE_MUX ou MIXERCONTROL_CONTROLTYPE_MIXER, mas não permitirá nenhuma manipulação do sinal.

szShortName[MIXER_SHORT_NAME_CHARS]

Cadeia de caracteres curta que descreve a linha do mixer de áudio especificada no membro dwLineID . Essa descrição deve ser apropriada como um rótulo conciso para a linha.

szName[MIXER_LONG_NAME_CHARS]

Cadeia de caracteres que descreve a linha do mixer de áudio especificada no membro dwLineID . Essa descrição deve ser apropriada como uma descrição completa para a linha.

Target

Informações de mídia de destino.

Target.dwType

Tipo de dispositivo de mídia de destino associado à linha de áudio descrita na estrutura MIXERLINE . Um aplicativo deve ignorar informações de destino para tipos de dispositivo de mídia que não usa. Os seguintes valores são definidos:

Nome	Descrição
MIXERLINE_TARGETTYPE_AUX	A linha de áudio descrita pela estrutura MIXERLINE está estritamente associada ao dispositivo auxiliar detalhado nos membros restantes do membro da estrutura De destino da estrutura MIXERLINE .
MIXERLINE_TARGETTYPE_MIDIIN	A linha de áudio descrita pela estrutura MIXERLINE está estritamente associada ao dispositivo de entrada MIDI detalhado nos membros restantes do membro da estrutura De destino da estrutura MIXERLINE .
MIXERLINE_TARGETTYPE_MIDIOUT	A linha de áudio descrita pela estrutura MIXERLINE está estritamente associada ao dispositivo de saída MIDI detalhado nos membros restantes do membro da estrutura De destino da estrutura MIXERLINE .
MIXERLINE_TARGETTYPE_UNDEFINED	A linha de áudio descrita pela estrutura MIXERLINE não está estritamente associada a um tipo de mídia definido. Todos os membros restantes da estrutura DE DESTINO da estrutura MIXERLINE devem ser ignorados. Um aplicativo não pode usar o tipo de destino MIXERLINE_TARGETTYPE_UNDEFINED ao chamar a função mixerGetLineInfo com o sinalizador MIXER_GETLINEINFOF_TARGETTYPE.
MIXERLINE_TARGETTYPE_WAVEIN	A linha de áudio descrita pela estrutura MIXERLINE está estritamente associada ao dispositivo de entrada waveform-audio detalhado nos membros restantes do membro da estrutura De destino da estrutura MIXERLINE .
MIXERLINE_TARGETTYPE_WAVEOUT	A linha de áudio descrita pela estrutura MIXERLINE está estritamente associada ao dispositivo de saída waveform-audio detalhado nos membros restantes do membro da estrutura De destino da estrutura MIXERLINE .

Target.dwDeviceID

Identificador de dispositivo atual do dispositivo de mídia de destino quando o membro dwType é um tipo de destino diferente de MIXERLINE_TARGETTYPE_UNDEFINED. Esse identificador é idêntico ao índice de dispositivo de mídia atual do dispositivo de mídia associado. Ao chamar a função mixerGetLineInfo com o sinalizador MIXER_GETLINEINFOF_TARGETTYPE, esse membro é ignorado na entrada e será retornado ao chamador pelo gerenciador de mixer de áudio.

Target.wMid

Identificador do fabricante do dispositivo de mídia de destino quando o membro dwType é um tipo de destino diferente de MIXERLINE_TARGETTYPE_UNDEFINED. Esse identificador é idêntico ao membro wMid da estrutura device-capabilities para a mídia associada. Os identificadores do fabricante são definidos em Identificadores de Fabricante e Produto.

Target.wPid

Identificador de produto do dispositivo de mídia de destino quando o membro dwType é um tipo de destino diferente de MIXERLINE_TARGETTYPE_UNDEFINED. Esse identificador é idêntico ao membro wPid da estrutura device-capabilities para a mídia associada. Os identificadores de produto são definidos em Identificadores de Produto e Fabricante.

Target.vDriverVersion

Versão do driver do dispositivo de mídia de destino quando o membro dwType é um tipo de destino diferente de MIXERLINE_TARGETTYPE_UNDEFINED. Esta versão é idêntica ao membro vDriverVersion da estrutura device-capabilities para a mídia associada.

Target.szPname[MAXPNAMELEN]

Nome do produto do dispositivo de mídia de destino quando o membro dwType é um tipo de destino diferente de MIXERLINE_TARGETTYPE_UNDEFINED. Esse nome é idêntico ao membro szPname da estrutura device-capabilities para a mídia associada.

Comentários

Observação

O cabeçalho mmeapi.h define MIXERLINE como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	mmeapi.h

Confira também

Estruturas do Mixer de Áudio

Misturadores de áudio

MIXERCAPS

mixerGetDevCaps

Mixergetlineinfo