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 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 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 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 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 da função mixerGetLineControls para recuperar as informações de controle do controle especificado. Observe que o membro dwLineID da estrutura MIXERLINECONTROLS será retornado pelo dispositivo de 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 desejados. Esse membro é usado com o sinalizador MIXER_GETLINECONTROLSF_ONEBYTYPE da 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 em MIXERCONTROL.
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 membro cControls 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 deve ser chamado.
cbmxctrl
Tamanho, em bytes, de uma única estrutura MIXERCONTROL . O tamanho especificado neste membro deve ser pelo menos grande o suficiente para conter a estrutura MIXERCONTROL base. O tamanho total, em bytes, necessário para o buffer apontado pelo membro pamxctrl é o produto dos membros cbmxctrl e cControls 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 de mixer (incluindo o membro cbStruct de cada estrutura MIXERCONTROL ) ao retornar com êxito.
Comentários
Observação
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 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 |