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

Статья
08/24/2023

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

Синтаксис

MMRESULT mixerGetLineControls(
  HMIXEROBJ           hmxobj,
  LPMIXERLINECONTROLS pmxlc,
  DWORD               fdwControls
);

Параметры

hmxobj

Дескриптор объекта устройства микшера, к которому выполняется запрос.

pmxlc

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

fdwControls

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

Значение	Значение
MIXER_GETLINECONTROLSF_ALL	Параметр pmxlc ссылается на список структур MIXERCONTROL , которые будут получать сведения обо всех элементах управления, связанных с звуковой линией, определяемой элементом dwLineID структуры MIXERLINECONTROLS . Элемент cControls должен быть инициализирован числом элементов управления, связанных со строкой. Это число извлекается из элемента cControls структуры MIXERLINE, возвращаемой функцией mixerGetLineInfo . Член cbmxctrl должен быть инициализирован размером в байтах одной структуры MIXERCONTROL . Элемент pamxctrl должен указывать на первую структуру MIXERCONTROL , которая должна быть заполнена. Элементы dwControlID и dwControlType игнорируются для этого запроса.
MIXER_GETLINECONTROLSF_ONEBYID	Параметр pmxlc ссылается на одну структуру MIXERCONTROL , которая будет получать сведения об элементе управления, определяемом элементом dwControlID структуры MIXERLINECONTROLS . Элемент cControls должен быть инициализирован до 1. Член cbmxctrl должен быть инициализирован размером в байтах одной структуры MIXERCONTROL . Элемент pamxctrl должен указывать на структуру MIXERCONTROL для заполнения. Элементы 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 — это дескриптор ввода звукового сигнала, возвращаемый функцией 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, устройство микшера недоступно.

Требования


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

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

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

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

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