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

Статья
11/20/2024

Функция mixerGetLineControls извлекает один или несколько элементов управления, связанных с звуковой линией.

Синтаксис

MMRESULT mixerGetLineControlsW(
  HMIXEROBJ            hmxobj,
  LPMIXERLINECONTROLSW pmxlc,
  DWORD                fdwControls
);

Параметры

hmxobj

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

pmxlc

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

fdwControls

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

Ценность	Значение
MIXER_GETLINECONTROLSF_ALL	Параметр pmxlc ссылается на список структур MIXERCONTROL, которые будут получать сведения обо всех элементах управления, связанных с звуковой линией, определенной dwLineID элементом структуры MIXERLINECONTROLS. Элемент cControls должен быть инициализирован в число элементов управления, связанных с строкой. Это число извлекается из элемента cControls структуры MIXERLINE, возвращаемой функцией mixerGetLineInfo. Элемент cbmxctrl должен быть инициализирован в размер в байтах одной структуры MIXERCONTROL. Элемент pamxctrl должен указывать на первую структуру MIXERCONTROL. Элементы dwControlID dwControlID и dwControlType игнорируются для этого запроса.
MIXER_GETLINECONTROLSF_ONEBYID	Параметр pmxlc ссылается на одну структуру MIXERCONTROL, которая будет получать сведения об элементе управления, определяемом элементом dwControlID структуры MIXERLINECONTROLS. Элемент cControls должен быть инициализирован до 1. Элемент cbmxctrl должен быть инициализирован в размер в байтах одной структуры MIXERCONTROL. Элемент pamxctrl должен указывать на структуру MIXERCONTROL. Элементы dwLineID dwLineID и dwControlType игнорируются для этого запроса. Этот запрос обычно используется для обновления элемента управления после получения сообщения уведомления об изменении MM_MIXM_CONTROL_CHANGE управления с помощью определяемого пользователем обратного вызова (см. mixerOpen).
MIXER_GETLINECONTROLSF_ONEBYTYPE	Функция mixerGetLineControls извлекает сведения о первом элементе управления определенного класса для запрашиваемой звуковой линии. Параметр pmxlc ссылается на одну структуру MIXERCONTROL, которая будет получать сведения о конкретном элементе управления. Звуковая строка определяется элементом dwLineID. Класс управления указан в элементе dwControlType структуры MIXERLINECONTROLS. Элемент dwControlID игнорируется для этого запроса. Этот запрос можно использовать приложением для получения сведений об одном элементе управления, связанном с строкой. Например, может потребоваться, чтобы ваше приложение использовало пиковый метр только из линии выходных данных волны-аудио.
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	Ссылка на элемент управления недопустимая.
MIXERR_INVALLINE	Ссылка на аудиолайн является недопустимой.
MMSYSERR_BADDEVICEID	Параметр hmxobj указывает недопустимый идентификатор устройства.
MMSYSERR_INVALFLAG	Один или несколько флагов недопустимы.
MMSYSERR_INVALHANDLE	Параметр hmxobj указывает недопустимый дескриптор.
MMSYSERR_INVALPARAM	Один или несколько параметров недопустимы.
MMSYSERR_NODRIVER	Для объекта, указанного hmxobj, не доступно устройство миксера.

Замечания

Заметка

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

Требования

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

См. также

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

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

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