Estrutura MIXERLINECONTROLSA (mmeapi.h)

A estrutura MIXERLINECONTROLS contém informações sobre os controles de uma linha de áudio.

Sintaxe

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

Membros

cbStruct

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

dwLineID

Identificador de linha para o qual os controles estão sendo consultados. Esse membro não será usado se o sinalizador de MIXER_GETLINECONTROLSF_ONEBYID for especificado para a função mixerGetLineControls, mas o dispositivo de mixer ainda retornará esse membro nesse caso. Os membros dwControlID e dwControlType não são usados quando MIXER_GETLINECONTROLSF_ALL é especificado.

DUMMYUNIONNAME

DUMMYUNIONNAME.dwControlID

Identificador de controle do controle desejado. Esse membro é usado com o sinalizador MIXER_GETLINECONTROLSF_ONEBYID para a função mixerGetLineControls para recuperar as informações de controle do controle especificado. Observe que o dwLineID membro da estrutura MIXERLINECONTROLS será retornado pelo dispositivo do mixer e não é necessário como um parâmetro de entrada. Esse membro se sobrepõe ao membro dwControlType e não pode ser usado em conjunto com o tipo de consulta MIXER_GETLINECONTROLSF_ONEBYTYPE.

DUMMYUNIONNAME.dwControlType

Classe dos tipos de controle de desejados. Esse membro é usado com o sinalizador MIXER_GETLINECONTROLSF_ONEBYTYPE para a função mixerGetLineControls para recuperar o primeiro controle da classe especificada na linha especificada pelo membro dwLineID da estrutura MIXERLINECONTROLS. Esse membro se sobrepõe ao membro dwControlID e não pode ser usado em conjunto com o tipo de consulta MIXER_GETLINECONTROLSF_ONEBYID. Consulte a descrição do membro dwControlType noMIXERCONTROL.

cControls

Número de elementos de estrutura MIXERCONTROL a serem recuperados. Esse membro deve ser inicializado pelo aplicativo antes de chamar a função mixerGetLineControls. Esse membro só poderá ser 1 se MIXER_GETLINECONTROLSF_ONEBYID ou MIXER_GETLINECONTROLSF_ONEBYTYPE for especificado ou o valor retornado no cControls membro da estrutura MIXERLINE retornado para uma linha de áudio. Este membro não pode ser zero. Se uma linha de áudio especificar que não tem controles, mixerGetLineControls não deverá ser chamado.

cbmxctrl

Tamanho, em bytes, de uma única estrutura de MIXERCONTROL. O tamanho especificado neste membro deve ser, pelo menos, grande o suficiente para conter a estrutura de MIXERCONTROL base. O tamanho total, em bytes, necessário para o buffer apontado pelo membro do pamxctrl é o produto do cbmxctrl e cControls membros da estrutura MIXERLINECONTROLS.

pamxctrl

Ponteiro para uma ou mais estruturas MIXERCONTROL para receber as propriedades dos controles de linha de áudio solicitados. Esse membro não pode ser NULL e deve ser inicializado antes de chamar a função mixerGetLineControls. Cada elemento da matriz de controles deve ser pelo menos grande o suficiente para conter uma estrutura MIXERCONTROL base. O membro cbmxctrl deve especificar o tamanho, em bytes, de cada elemento nessa matriz. Nenhuma inicialização do buffer apontado por esse membro é exigida pelo aplicativo. Todos os membros são preenchidos pelo dispositivo do mixer (incluindo o membro cbStruct de cada estrutura MIXERCONTROL) ao retornar com êxito.

Observações

Nota

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

Requisitos

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

Consulte também

de Estruturas de Mixer de Áudio

de Audio Mixers

MIXERCONTROL

MIXERLINE

mixerGetLineControls