Função mixerGetLineControlsW (mmeapi.h)
A função mixerGetLineControls recupera um ou mais controles associados a uma linha de áudio.
Sintaxe
MMRESULT mixerGetLineControlsW(
HMIXEROBJ hmxobj,
LPMIXERLINECONTROLSW pmxlc,
DWORD fdwControls
);
Parâmetros
hmxobj
Identificador para o objeto de dispositivo do mixer que está sendo consultado.
pmxlc
Ponteiro para uma estrutura 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 membro cbStruct da estrutura MIXERLINECONTROLS deve sempre ser 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 MIXERCONTROL que receberão informações sobre todos os controles associados à linha de áudio identificada pelo membro dwLineID da estrutura MIXERLINECONTROLS . O membro cControls deve ser inicializado para o número de controles associados à linha. Esse número é recuperado do membro cControls da estrutura MIXERLINE retornada pela função mixerGetLineInfo . O membro cbmxctrl deve ser inicializado para o tamanho, em bytes, de uma única estrutura MIXERCONTROL . O membro 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 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 MIXERCONTROL que receberá informações sobre o controle específico. A linha de áudio é identificada pelo membro dwLineID . A classe de controle é especificada no membro dwControlType da estrutura 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 somente de uma linha de saída de áudio de forma de onda. |
| 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 menor 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 menor 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 menor 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 a menos do 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 a menos do que o número de dispositivos retornados pela função waveOutGetNumDevs . |
Valor retornado
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 |
|---|---|
|
A referência de controle é inválida. |
|
A referência de linha de áudio é inválida. |
|
O parâmetro hmxobj especifica um identificador de dispositivo inválido. |
|
Um ou mais sinalizadores são inválidos. |
|
O parâmetro hmxobj especifica um identificador inválido. |
|
Um ou mais parâmetros são inválidos. |
|
Nenhum dispositivo de mixer está disponível para o objeto especificado por hmxobj. |
Comentários
Observação
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 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
| 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] |
| Plataforma de Destino | Windows |
| Cabeçalho | mmeapi.h (inclua Windows.h) |
| Biblioteca | Winmm.lib |
| DLL | Winmm.dll |