Função mixerGetControlDetailsA (mmeapi.h)

Artigo
11/20/2024

A função mixerGetControlDetails recupera detalhes sobre um único controle associado a uma linha de áudio.

Sintaxe

MMRESULT mixerGetControlDetailsA(
  HMIXEROBJ             hmxobj,
  LPMIXERCONTROLDETAILS pmxcd,
  DWORD                 fdwDetails
);

Parâmetros

hmxobj

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

pmxcd

Ponteiro para uma estrutura MIXERCONTROLDETAILS, que é preenchida com informações de estado sobre o controle.

fdwDetails

Sinalizadores para recuperar detalhes do controle. Os valores a seguir são definidos.

Valor	Significado
MIXER_GETCONTROLDETAILSF_LISTTEXT	O paDetails membro da estrutura MIXERCONTROLDETAILS aponta para uma ou mais estruturas MIXERCONTROLDETAILS_LISTTEXT para receber rótulos de texto para controles de vários itens. Um aplicativo deve obter todos os itens de texto de lista para um controle de vários itens ao mesmo tempo. Esse sinalizador não pode ser usado com controles MIXERCONTROL_CONTROLTYPE_CUSTOM.
MIXER_GETCONTROLDETAILSF_VALUE	Os valores atuais de um controle são recuperados. O paDetails membro da estrutura MIXERCONTROLDETAILS aponta para uma ou mais estruturas de detalhes apropriadas para a classe de controle.
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 (Interface Digital do Instrumento Musical). 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.
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

Todos os membros da estrutura MIXERCONTROLDETAILS devem ser inicializados antes de chamar essa função.

Nota

O cabeçalho mmeapi.h define mixerGetControlDetails 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 Mmeapi.h, Windows.h)
biblioteca	Winmm.lib
de DLL	Winmm.dll

Consulte também

Funções do Desempate de Áudio

de Audio Mixers

Compartilhar via