Структура MIXERLINECONTROLS (mmeapi.h)
Структура MIXERLINECONTROLS содержит сведения об элементах управления звуковой линии.
Синтаксис
typedef struct tMIXERLINECONTROLS {
DWORD cbStruct;
DWORD dwLineID;
union {
DWORD dwControlID;
DWORD dwControlType;
};
DWORD cControls;
DWORD cbmxctrl;
LPMIXERCONTROL pamxctrl;
} MIXERLINECONTROLS, *PMIXERLINECONTROLS, *LPMIXERLINECONTROLS;
Члены
cbStruct
Размер структуры MIXERLINECONTROLS в байтах . Этот элемент необходимо инициализировать перед вызовом функции mixerGetLineControls . Размер, указанный в этом элементе, должен быть достаточно большим, чтобы содержать структуру MIXERLINECONTROLS . При возврате mixerGetLineControls этот элемент содержит фактический размер возвращаемых сведений. Возвращаемые сведения не будут превышать запрошенный размер и не будут меньше структуры MIXERLINECONTROLS .
dwLineID
Идентификатор строки, для которой запрашиваются элементы управления. Этот элемент не используется, если для функции mixerGetLineControls задан флаг MIXER_GETLINECONTROLSF_ONEBYID, но в этом случае устройство микшера по-прежнему возвращает этот элемент. Члены dwControlID и dwControlType не используются при указании MIXER_GETLINECONTROLSF_ALL.
dwControlID
Идентификатор нужного элемента управления. Этот элемент используется с флагом MIXER_GETLINECONTROLSF_ONEBYID для функции mixerGetLineControls для получения сведений об элементе управления указанного элемента управления. Обратите внимание, что элемент dwLineID структуры MIXERLINECONTROLS возвращается устройством микшера и не требуется в качестве входного параметра. Этот элемент перекрывается с элементом dwControlType и не может использоваться в сочетании с типом запроса MIXER_GETLINECONTROLSF_ONEBYTYPE.
dwControlType
Класс требуемых типов элементов управления. Этот элемент используется с флагом MIXER_GETLINECONTROLSF_ONEBYTYPE для функции mixerGetLineControls для получения первого элемента управления указанного класса в строке, заданной членом dwLineID структуры MIXERLINECONTROLS . Этот элемент перекрывается с элементом dwControlID и не может использоваться вместе с типом запроса MIXER_GETLINECONTROLSF_ONEBYID. См. описание элемента dwControlType в MIXERCONTROL.
cControls
Количество извлекаемых элементов структуры MIXERCONTROL . Этот элемент должен быть инициализирован приложением перед вызовом функции mixerGetLineControls . Этот элемент может быть равен 1, только если указан MIXER_GETLINECONTROLSF_ONEBYID или MIXER_GETLINECONTROLSF_ONEBYTYPE или значение, возвращаемое в элементе cControls структуры MIXERLINE , возвращаемое для звуковой строки. Этот элемент не может быть равен нулю. Если в звуковой строке указано, что у нее нет элементов управления, не следует вызывать mixerGetLineControls .
cbmxctrl
Размер одной структуры MIXERCONTROL в байтах. Размер, указанный в этом элементе, должен быть по крайней мере достаточно большим, чтобы содержать базовую структуру MIXERCONTROL . Общий размер в байтах, необходимый для буфера, на который указывает член pamxctrl , является произведением членов cbmxctrl и cControls структуры MIXERLINECONTROLS .
pamxctrl
Указатель на одну или несколько структур MIXERCONTROL для получения свойств запрошенных элементов управления звуковой строкой. Этот член не может иметь значение NULL и должен быть инициализирован перед вызовом функции mixerGetLineControls . Каждый элемент массива элементов управления должен быть по крайней мере достаточно большим, чтобы содержать базовую структуру MIXERCONTROL . Член cbmxctrl должен указывать размер (в байтах) каждого элемента в этом массиве. Приложение не требует инициализации буфера, на который указывает этот элемент. Все элементы заполняются устройством микшера (включая элемент cbStruct каждой структуры MIXERCONTROL ) после успешного возврата.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | mmeapi.h |