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

функция mixerGetControlDetails (mmeapi.h)

  • Статья

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

Синтаксис

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

Параметры

hmxobj

Обработка запрашиваемого объекта устройства микшера.

pmxcd

Указатель на структуру MIXERCONTROLDETAILS , заполненную сведениями о состоянии элемента управления.

fdwDetails

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

Значение Значение
MIXER_GETCONTROLDETAILSF_LISTTEXT Элемент paDetails структуры MIXERCONTROLDETAILS указывает на одну или несколько MIXERCONTROLDETAILS_LISTTEXT структур для получения текстовых меток для элементов управления с несколькими элементами. Приложение должно получить все текстовые элементы списка для элемента управления с несколькими элементами одновременно. Этот флаг нельзя использовать с элементами управления MIXERCONTROL_CONTROLTYPE_CUSTOM.
MIXER_GETCONTROLDETAILSF_VALUE Извлекаются текущие значения для элемента управления. Элемент paDetails структуры MIXERCONTROLDETAILS указывает на одну или несколько структур сведений, подходящих для класса элемента управления.
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 .

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

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

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

Комментарии

Перед вызовом этой функции необходимо инициализировать все члены структуры MIXERCONTROLDETAILS .

Требования

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

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

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

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