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 |
|---|---|
|
A referência de controle é 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
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 |