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

Статья
11/20/2024

Функция 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 в структуре MIXERCONTROLDETAIL S указывает на одну или несколько подробных структур, подходящих для класса управления.
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 — это дескриптор вывода звука, возвращаемый функцией waveOutOpen.
MIXER_OBJECTF_MIDIIN	Параметр hmxobj является идентификатором устройства ввода MIDI. Этот идентификатор должен находиться в диапазоне от нуля до одного меньше числа устройств, возвращаемых функцией midiInGetNumDevs.
MIXER_OBJECTF_MIDIOUT	Параметр hmxobj является идентификатором выходного устройства MIDI. Этот идентификатор должен находиться в диапазоне от нуля до одного меньше числа устройств, возвращаемых функцией midiOutGetNumDevs.
MIXER_OBJECTF_MIXER	Параметр hmxobj — это идентификатор устройства миксера в диапазоне от нуля до одного, чем число устройств, возвращаемых функцией mixerGetNumDevs. Этот флаг является необязательным.
MIXER_OBJECTF_WAVEIN	Параметр hmxobj — это идентификатор устройства ввода волны в диапазоне от нуля до одного, чем число устройств, возвращаемых функцией waveInGetNumDevs.
MIXER_OBJECTF_WAVEOUT	Параметр hmxobj — это идентификатор устройства вывода волны в диапазоне от нуля до одного, чем число устройств, возвращаемых функцией waveOutGetNumDevs.

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

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

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

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	mmeapi.h (include Mmeapi.h, Windows.h)
библиотеки	Winmm.lib
DLL	Winmm.dll

См. также

функции Миксера звука

звуковых миксеров

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