Структура MIXERLINECONTROLSA (mmeapi.h)

Статья
11/20/2024

Структура MIXERLINECONTROLS содержит сведения об элементах управления звуковой линии.

Синтаксис

typedef struct tagMIXERLINECONTROLSA {
  DWORD           cbStruct;
  DWORD           dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  } DUMMYUNIONNAME;
  DWORD           cControls;
  DWORD           cbmxctrl;
  LPMIXERCONTROLA pamxctrl;
} MIXERLINECONTROLSA, *PMIXERLINECONTROLSA, *LPMIXERLINECONTROLSA;

Члены

cbStruct

Размер в байтах структуры MIXERLINECONTROLS . Этот элемент необходимо инициализировать перед вызовом функции mixerGetLineControls. Размер, указанный в этом элементе, должен быть достаточно большим, чтобы содержать структуру MIXERLINECONTROLS. Когда mixerGetLineControls возвращается, этот элемент содержит фактический размер возвращаемой информации. Возвращаемые сведения не будут превышать запрошенный размер, а также не будут меньше, чем структура MIXERLINECONTROLS.

dwLineID

Идентификатор строки, для которой запрашиваются элементы управления. Этот элемент не используется, если флаг MIXER_GETLINECONTROLSF_ONEBYID указан для функции mixerGetLineControls, но устройство смешивания по-прежнему возвращает этот элемент в данном случае. Элементы dwControlID dwControlID и dwControlType не используются при указании MIXER_GETLINECONTROLSF_ALL.

DUMMYUNIONNAME

DUMMYUNIONNAME.dwControlID

Идентификатор элемента управления, требуемого элемента управления. Этот элемент используется с флагом MIXER_GETLINECONTROLSF_ONEBYID для функции mixerGetLineControls для получения сведений об элементе управления указанного элемента управления. Обратите внимание, что элемент dwLineID структуры MIXERLINECONTROLS будет возвращен устройством миксера и не требуется в качестве входного параметра. Этот элемент пересекается с элементом dwControlType и не может использоваться в сочетании с типом запроса MIXER_GETLINECONTROLSF_ONEBYTYPE.

DUMMYUNIONNAME.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) после успешного возвращения.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	mmeapi.h

См. также

структуры миксера звука

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