Поделиться через

Функция mixerSetControlDetails (mmeapi.h)

  • Статья

Функция mixerSetControlDetails задает свойства одного элемента управления, связанного с звуковой строкой.

Синтаксис

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

Параметры

hmxobj

Обработка объекта устройства микшера, для которого задаются свойства.

pmxcd

Указатель на структуру MIXERCONTROLDETAILS . Эта структура используется для ссылки на структуры сведений об элементах управления, которые содержат требуемое состояние элемента управления.

fdwDetails

Флаги для задания свойств элемента управления. Определены следующие значения.

Значение Значение
MIXER_OBJECTF_AUX Параметр hmxobj — это вспомогательный идентификатор устройства в диапазоне от нуля до единицы меньше числа устройств, возвращаемых функцией auxGetNumDevs .
MIXER_OBJECTF_HMIDIIN Параметр hmxobj — это дескриптор устройства ввода MIDI. Этот дескриптор должен быть возвращен функцией midiInOpen .
MIXER_OBJECTF_HMIDIOUT Параметр hmxobj — это дескриптор устройства вывода MIDI. Этот дескриптор должен быть возвращен функцией midiOutOpen .
MIXER_OBJECTF_HMIXER Параметр hmxobj — это дескриптор устройства микшера, возвращаемый функцией mixerOpen . Этот флаг является необязательным.
MIXER_OBJECTF_HWAVEIN Параметр hmxobj — это дескриптор ввода waveform-audio, возвращаемый функцией waveInOpen .
MIXER_OBJECTF_HWAVEOUT Параметр hmxobj — это дескриптор вывода waveform-audio, возвращаемый функцией waveOutOpen .
MIXER_OBJECTF_MIDIIN Параметр hmxobj — это идентификатор устройства ввода MIDI. Этот идентификатор должен находиться в диапазоне от нуля до единицы меньше числа устройств, возвращаемых функцией midiInGetNumDevs .
MIXER_OBJECTF_MIDIOUT Параметр hmxobj — это идентификатор устройства вывода MIDI. Этот идентификатор должен находиться в диапазоне от нуля до единицы меньше числа устройств, возвращаемых функцией midiOutGetNumDevs .
MIXER_OBJECTF_MIXER Параметр hmxobj — это идентификатор устройства микшера в диапазоне от нуля до единицы меньше числа устройств, возвращаемых функцией mixerGetNumDevs . Этот флаг является необязательным.
MIXER_OBJECTF_WAVEIN Параметр hmxobj — это идентификатор устройства ввода waveform-audio в диапазоне от нуля до единицы меньше числа устройств, возвращаемых функцией waveInGetNumDevs .
MIXER_OBJECTF_WAVEOUT Параметр hmxobj — это идентификатор устройства вывода waveform-audio в диапазоне от нуля до единицы меньше числа устройств, возвращаемых функцией waveOutGetNumDevs .
MIXER_SETCONTROLDETAILSF_CUSTOM Откроется настраиваемое диалоговое окно для указанного пользовательского элемента управления микшером. Устройство микшера собирает необходимые сведения от пользователя и возвращает данные в указанном буфере. Дескриптор окна-владельца указывается в элементе hwndOwner структуры MIXERCONTROLDETAILS . (Для этого дескриптора можно задать значение NULL.) Затем приложение может сохранить данные из диалогового окна и использовать их позже для сброса элемента управления в то же состояние с помощью флага MIXER_SETCONTROLDETAILSF_VALUE.
MIXER_SETCONTROLDETAILSF_VALUE Задаются текущие значения для элемента управления. Элемент paDetails структуры MIXERCONTROLDETAILS указывает на одну или несколько структур сведений элемента управления миксером соответствующего класса для элемента управления.

Возвращаемое значение

Возвращает MMSYSERR_NOERROR в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:

Код возврата Описание
MIXERR_INVALCONTROL
 Недопустимая ссылка на элемент управления.
MMSYSERR_BADDEVICEID
 Параметр hmxobj указывает недопустимый идентификатор устройства.
MMSYSERR_INVALFLAG
 Один или несколько флагов недопустимы.
MMSYSERR_INVALHANDLE
 Параметр hmxobj указывает недопустимый дескриптор.
MMSYSERR_INVALPARAM
 Один или несколько параметров недопустимы.
MMSYSERR_NODRIVER
 Для объекта, указанного в hmxobj, не доступно устройство микшера.

Комментарии

Все элементы структуры MIXERCONTROLDETAILS должны быть инициализированы перед вызовом mixerSetControlDetails.

Если приложению требуется получить только текущее состояние пользовательского элемента управления микшером и не отображать диалоговое окно, то mixerGetControlDetails можно использовать с флагом MIXER_GETCONTROLDETAILSF_VALUE.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mmeapi.h (включая Windows.h)
Библиотека Winmm.lib
DLL Winmm.dll

См. также раздел

Функции аудио микшера

Аудио микшеры