Função mixerSetControlDetails (mmeapi.h)

A função mixerSetControlDetails define as propriedades de um único controle associado a uma linha de áudio.

Sintaxe

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

Parâmetros

hmxobj

Identificador para o objeto de dispositivo do mixer para o qual as propriedades estão sendo definidas.

pmxcd

Ponteiro para uma estrutura MIXERCONTROLDETAILS . Essa estrutura é usada para referenciar estruturas de detalhes de controle que contêm o estado desejado para o controle.

fdwDetails

Sinalizadores para definir propriedades para um controle. Os valores a seguir são definidos.

Valor	Significado
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 é um identificador de 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 .
MIXER_SETCONTROLDETAILSF_CUSTOM	Uma caixa de diálogo personalizada para o controle de mixer personalizado especificado é exibida. O dispositivo de mixer coleta as informações necessárias do usuário e retorna os dados no buffer especificado. O identificador da janela proprietária é especificado no membro hwndOwner da estrutura MIXERCONTROLDETAILS . (Esse identificador pode ser definido como NULL.) Em seguida, o aplicativo pode salvar os dados da caixa de diálogo e usá-los posteriormente para redefinir o controle para o mesmo estado usando o sinalizador MIXER_SETCONTROLDETAILSF_VALUE.
MIXER_SETCONTROLDETAILSF_VALUE	Os valores atuais de um controle são definidos. O membro paDetails da estrutura MIXERCONTROLDETAILS aponta para uma ou mais estruturas de detalhes de controle de mixer da classe apropriada para o controle.

Retornar valor

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.

Comentários

Todos os membros da estrutura MIXERCONTROLDETAILS devem ser inicializados antes de chamar mixerSetControlDetails.

Se um aplicativo precisar recuperar apenas o estado atual de um controle de mixer personalizado e não exibir uma caixa de diálogo, o mixerGetControlDetails poderá ser usado com o sinalizador MIXER_GETCONTROLDETAILSF_VALUE.

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]
Plataforma de Destino	Windows
Cabeçalho	mmeapi.h (inclua Windows.h)
Biblioteca	Winmm.lib
DLL	Winmm.dll

Confira também

Funções de mixer de áudio

Combinadores de áudio