Função mixerGetLineControlsA (mmeapi.h)

Artigo
11/20/2024

A função mixerGetLineControls recupera um ou mais controles associados a uma linha de áudio.

Sintaxe

MMRESULT mixerGetLineControlsA(
  HMIXEROBJ            hmxobj,
  LPMIXERLINECONTROLSA pmxlc,
  DWORD                fdwControls
);

Parâmetros

hmxobj

Manipule para o objeto de dispositivo do mixer que está sendo consultado.

pmxlc

Ponteiro para uma estrutura de MIXERLINECONTROLS. Essa estrutura é usada para referenciar uma ou mais estruturas MIXERCONTROL a serem preenchidas com informações sobre os controles associados a uma linha de áudio. O cbStruct membro da estrutura MIXERLINECONTROLS deve ser sempre inicializado para ser o tamanho, em bytes, da estrutura MIXERLINECONTROLS.

fdwControls

Sinalizadores para recuperar informações sobre um ou mais controles associados a uma linha de áudio. Os valores a seguir são definidos.

Valor	Significado
MIXER_GETLINECONTROLSF_ALL	O parâmetro pmxlc faz referência a uma lista de estruturas de MIXERCONTROL que receberão informações sobre todos os controles associados à linha de áudio identificada pelo membro dwLineID da estrutura MIXERLINECONTROLS. O cControls membro deve ser inicializado para o número de controles associados à linha. Esse número é recuperado do cControls membro da estrutura de MIXERLINE retornada pela função mixerGetLineInfo. O membro cbmxctrl deve ser inicializado para o tamanho, em bytes, de uma única estrutura MIXERCONTROL. O membro do pamxctrl deve apontar para a primeira estrutura MIXERCONTROL a ser preenchida. Os membros dwControlID e dwControlType são ignorados para essa consulta.
MIXER_GETLINECONTROLSF_ONEBYID	O parâmetro pmxlc faz referência a uma única estrutura de MIXERCONTROL que receberá informações sobre o controle identificado pelo membro dwControlID da estrutura MIXERLINECONTROLS. O membro cControls deve ser inicializado como 1. O membro cbmxctrl deve ser inicializado para o tamanho, em bytes, de uma única estrutura MIXERCONTROL. O membro pamxctrl deve apontar para uma estrutura MIXERCONTROL a ser preenchida. Os membros dwLineID e dwControlType são ignorados para essa consulta. Essa consulta geralmente é usada para atualizar um controle depois de receber uma mensagem de notificação de alteração de controle MM_MIXM_CONTROL_CHANGE pelo retorno de chamada definido pelo usuário (consulte mixerOpen).
MIXER_GETLINECONTROLSF_ONEBYTYPE	A função mixerGetLineControls recupera informações sobre o primeiro controle de uma classe específica para a linha de áudio que está sendo consultada. O parâmetro pmxlc faz referência a uma única estrutura de MIXERCONTROL que receberá informações sobre o controle específico. A linha de áudio é identificada pelo membro dwLineID . A classe de controle é especificada no dwControlType membro da estrutura de MIXERLINECONTROLS. O membro dwControlID é ignorado para essa consulta. Essa consulta pode ser usada por um aplicativo para obter informações sobre um único controle associado a uma linha. Por exemplo, talvez você queira que seu aplicativo use um medidor de pico apenas de uma linha de saída de forma de onda de áudio.
MIXER_OBJECTF_AUX	O parâmetro hmxobj é um identificador de dispositivo auxiliar no intervalo de zero a um a menos do que o número de dispositivos retornados pela função auxGetNumDevs.
MIXER_OBJECTF_HMIDIIN	O parâmetro hmxobj é o identificador de um dispositivo de entrada MIDI. Esse identificador deve ter sido retornado pela função midiInOpen.
MIXER_OBJECTF_HMIDIOUT	O parâmetro hmxobj é o identificador de um dispositivo de saída MIDI. Esse identificador deve ter sido retornado pela função midiOutOpen .
MIXER_OBJECTF_HMIXER	O parâmetro hmxobj é um identificador de dispositivo de mixer retornado pela função mixerOpen. Esse sinalizador é opcional.
MIXER_OBJECTF_HWAVEIN	O parâmetro hmxobj é um identificador de entrada waveform-audio retornado pela função waveInOpen .
MIXER_OBJECTF_HWAVEOUT	O parâmetro hmxobj é um identificador de saída waveform-audio retornado pela função waveOutOpen .
MIXER_OBJECTF_MIDIIN	O parâmetro hmxobj é o identificador de um dispositivo de entrada MIDI. Esse identificador deve estar no intervalo de zero a um a menos do que o número de dispositivos retornados pela função midiInGetNumDevs.
MIXER_OBJECTF_MIDIOUT	O parâmetro hmxobj é o identificador de um dispositivo de saída MIDI. Esse identificador deve estar no intervalo de zero a um a menos do que o número de dispositivos retornados pela função midiOutGetNumDevs.
MIXER_OBJECTF_MIXER	O parâmetro hmxobj é o identificador de um dispositivo de mixer no intervalo de zero a um a menos do que o número de dispositivos retornados pela função mixerGetNumDevs. Esse sinalizador é opcional.
MIXER_OBJECTF_WAVEIN	O parâmetro hmxobj é o identificador de um dispositivo de entrada waveform-audio no intervalo de zero a um menor que o número de dispositivos retornados pela função waveInGetNumDevs .
MIXER_OBJECTF_WAVEOUT	O parâmetro hmxobj é o identificador de um dispositivo de saída waveform-audio no intervalo de zero a um menor que o número de dispositivos retornados pela função waveOutGetNumDevs.

Valor de retorno

Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno	Descrição
MIXERR_INVALCONTROL	A referência de controle é inválida.
MIXERR_INVALLINE	A referência de linha de áudio é inválida.
MMSYSERR_BADDEVICEID	O parâmetro hmxobj especifica um identificador de dispositivo inválido.
MMSYSERR_INVALFLAG	Um ou mais sinalizadores são inválidos.
MMSYSERR_INVALHANDLE	O parâmetro hmxobj especifica um identificador inválido.
MMSYSERR_INVALPARAM	Um ou mais parâmetros são inválidos.
MMSYSERR_NODRIVER	Nenhum dispositivo de mixer está disponível para o objeto especificado por hmxobj.

Observações

Nota

O cabeçalho mmeapi.h define mixerGetLineControls 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]
da Plataforma de Destino	Windows
cabeçalho	mmeapi.h (inclua Windows.h)
biblioteca	Winmm.lib
de DLL	Winmm.dll

Consulte também

Funções do Desempate de Áudio

de Audio Mixers

Compartilhar via