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

Статья
08/24/2023

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

Синтаксис

MMRESULT mixerGetControlDetailsA(
  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, не доступно устройство микшера.

Заголовок mmeapi.h определяет mixerGetControlDetails в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


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

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

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

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

Share via