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

Структура MIXERLINE описывает состояние и метрики звуковой линии.

Синтаксис

typedef struct tagMIXERLINEA {
  DWORD     cbStruct;
  DWORD     dwDestination;
  DWORD     dwSource;
  DWORD     dwLineID;
  DWORD     fdwLine;
  DWORD_PTR dwUser;
  DWORD     dwComponentType;
  DWORD     cChannels;
  DWORD     cConnections;
  DWORD     cControls;
  CHAR      szShortName[MIXER_SHORT_NAME_CHARS];
  CHAR      szName[MIXER_LONG_NAME_CHARS];
  struct {
    DWORD     dwType;
    DWORD     dwDeviceID;
    WORD      wMid;
    WORD      wPid;
    MMVERSION vDriverVersion;
    CHAR      szPname[MAXPNAMELEN];
  } Target;
} MIXERLINEA, *PMIXERLINEA, *LPMIXERLINEA;

Члены

cbStruct

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

dwDestination

Индекс конечной строки. Этот элемент в диапазоне от нуля до одного меньше значения, указанного в элементе cDestinations структуры MIXERCAPS , полученной функцией mixerGetDevCaps . При вызове функции mixerGetLineInfo с флагом MIXER_GETLINEINFOF_DESTINATION возвращаются свойства строки назначения. (В этом случае для элемента dwSource необходимо задать нулевое значение.) При вызове с флагом MIXER_GETLINEINFOF_SOURCE возвращаются свойства источника, заданного элементом dwSource , связанным с элементом dwDestination .

dwSource

Индекс строки источника звука, связанной с элементом dwDestination . То есть этот элемент указывает n-юстроку источника звука, связанную с указанной конечной строкой аудио. Этот элемент не используется для конечных строк и должен иметь значение 0, если MIXER_GETLINEINFOF_DESTINATION указан в функции mixerGetLineInfo . Если указан флаг MIXER_GETLINEINFOF_SOURCE, этот элемент находится в диапазоне от нуля до одного меньше значения, указанного в элементе cConnections для строки назначения звука, указанной в элементе dwDestination .

dwLineID

Идентификатор, определенный микшерным устройством, который однозначно ссылается на звуковую линию, описанную структурой MIXERLINE . Этот идентификатор уникален для каждого микшерного устройства и может иметь любой формат. Приложение должно использовать этот идентификатор только в качестве абстрактного дескриптора.

fdwLine

Флаги состояния и поддержки для звуковой линии. Этот элемент всегда возвращается в приложение и не требует инициализации.

Имя	Описание
MIXERLINE_LINEF_ACTIVE	Активна звуковая линия. Активная линия указывает, что сигнал, вероятно, проходит через линию.
MIXERLINE_LINEF_DISCONNECTED	Звуковая линия отключена. Элементы управления, связанные с отключенной линией, по-прежнему можно изменить, но изменения не будут действовать до тех пор, пока линия не будет подключена.
MIXERLINE_LINEF_SOURCE	Звуковая строка — это строка источника звука, связанная с одной строкой назначения звука. Если этот флаг не установлен, эта строка является конечной строкой аудио, связанной с нулевым или несколькими строками источника звука.

 

Если приложение не использует устройство вывода звукового сигналов, связанная с этим устройством звуковая линия не будет активной (то есть флаг MIXERLINE_LINEF_ACTIVE не будет установлен).

Если устройство вывода waveform-audio открыто, звуковая линия считается активной и будет установлен флаг MIXERLINE_LINEF_ACTIVE.

Приостановленное или голодающее устройство вывода звукового звука по-прежнему считается активным. Иными словами, если устройство вывода волновой формы и звука открывается приложением независимо от того, воспроизводится ли данные, связанная с ним звуковая линия считается активной.

Если линия не может быть строго определена как активная, устройство микшера всегда устанавливает флаг MIXERLINE_LINEF_ACTIVE.

dwUser

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

dwComponentType

Тип компонента для этой звуковой линии. Приложение может использовать эти сведения для отображения специализированной графики или поиска определенного компонента. Если приложение не использует типы компонентов, этот элемент следует игнорировать. Этот элемент может иметь одно из следующих значений:

Имя	Описание
MIXERLINE_COMPONENTTYPE_DST_DIGITAL	Звуковая линия — это цифровое назначение (например, цифровой вход на звуковое устройство DAT или CD).
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES	Звуковая линия — это настраиваемое (усиление и/или затухание) назначение, предназначенное для наушников. Большинство звуковых карт используют одну и ту же линию назначения звука для динамиков и наушников. В этом случае микшерное устройство просто использует тип MIXERLINE_COMPONENTTYPE_DST_SPEAKERS.
MIXERLINE_COMPONENTTYPE_DST_LINE	Звуковая линия — это место назначения уровня линии (например, ввод на уровне строки с аудиоустройства CD), которое будет окончательным источником записи для аналогово-цифрового преобразователя (ADC). Поскольку большинство звуковых карт для персональных компьютеров обеспечивают некоторую выгоду для записи исходной строки аудио, микшерное устройство будет использовать тип MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_MONITOR	Звуковая линия — это место назначения, используемое для монитора.
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS	Звуковая линия — это настраиваемое (затухающее и/или затухающее) назначение, предназначенное для привода динамиков. Это типичный тип компонента для аудиовыходов звуковых карт для персональных компьютеров.
MIXERLINE_COMPONENTTYPE_DST_TELEPHONE	Аудиострока — это место назначения, которое будет направляться на телефонную линию.
MIXERLINE_COMPONENTTYPE_DST_UNDEFINED	Аудиострока — это назначение, которое не может быть определено одним из стандартных типов компонентов. Устройство микшера требуется для использования этого типа компонента для типов компонентов линии, которые не были определены корпорацией Майкрософт.
MIXERLINE_COMPONENTTYPE_DST_VOICEIN	Звуковая линия — это место назначения, которое будет окончательным источником записи для голосового ввода. Этот тип компонента точно такой же, как MIXERLINE_COMPONENTTYPE_DST_WAVEIN но предназначен специально для параметров, используемых во время записи и распознавания голоса. Поддержка этой строки является необязательной для микшерного устройства. Многие микшерные устройства предоставляют только MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_WAVEIN	Звуковая линия — это место назначения, которое будет окончательным источником записи для аудиовхода волновой формы (ADC). Эта линия обычно обеспечивает некоторое увеличение или затухание. Это типичный тип компонента для строки записи большинства звуковых карт для персональных компьютеров.
MIXERLINE_COMPONENTTYPE_SRC_ANALOG	Звуковая линия — это аналоговый источник (например, аналоговый вывод с видеокассеты).
MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY	Звуковая линия — это источник, исходящий из вспомогательной звуковой линии. Этот тип строки предназначен как источник с усилением или затуханием, который можно направить в MIXERLINE_COMPONENTTYPE_DST_SPEAKERS назначение и /или записать из MIXERLINE_COMPONENTTYPE_DST_WAVEIN назначения.
MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC	Звуковая линия — это источник, исходящий из выходных данных внутреннего звукового компакт-диска. Этот тип компонента предоставляется для звуковых карточек, которые предоставляют строку источника звука, предназначенную для подключения к звуковому компакт-диску (или компакт-диску для воспроизведения звукового компакт-диска).
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL	Звуковая линия — это цифровой источник (например, цифровой выход из DAT или аудио cd).
MIXERLINE_COMPONENTTYPE_SRC_LINE	Звуковая линия — это источник на уровне строки (например, входные данные на уровне строки из внешней стереосистемы), который можно использовать в качестве дополнительного источника записи. Поскольку большинство звуковых карт для персональных компьютеров обеспечивают какой-то выигрыш для исходной строки записи, микшер будет использовать тип MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY.
MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE	Звуковая линия — это источник записи микрофона. Большинство звуковых карт для персональных компьютеров предоставляют по крайней мере два типа источников записи: вспомогательную звуковую линию и входные данные с микрофона. Звуковая линия микрофона обычно обеспечивает какой-то выигрыш. Аудиоадаптеры, использующие один вход для использования с микрофоном или вспомогательной звуковой линией, должны использовать тип компонента MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE.
MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER	Звуковая линия — это источник, исходящий из динамиков персонального компьютера. Несколько звуковых карт для персональных компьютеров позволяют смешивать то, что обычно воспроизводится на внутреннем динамике, с выходом звукового карта. Некоторые звуковые карточки поддерживают возможность использования этих выходных данных в качестве источника записи.
MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER	Строка звука — это источник, исходящий из выходных данных внутреннего синтезатора. Большинство звуковых карт для персональных компьютеров предоставляют своего рода синтезатор MIDI.
MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE	Звуковая линия — это источник, исходящий из входящей телефонной линии.
MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED	Строка звука — это источник, который не может быть определен одним из стандартных типов компонентов. Устройство микшера требуется для использования этого типа компонента для типов компонентов линии, не определенных корпорацией Майкрософт.
MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT	Звуковая линия — это источник, исходящий из цифрового аналогового преобразователя (DAC) с выходом waveform-audio. Большинство звуковых карт для персональных компьютеров предоставляют этот тип компонента в качестве источника MIXERLINE_COMPONENTTYPE_DST_SPEAKERS назначения. Некоторые карточки также позволяют маршрутизировать этот источник в MIXERLINE_COMPONENTTYPE_DST_WAVEIN назначения.

cChannels

Максимальное количество отдельных каналов, которыми можно управлять независимо для звуковой линии. Минимальное значение для этого поля равно 1, так как строка должна иметь по крайней мере один канал.

Большинство современных звуковых карт для персональных компьютеров являются стереоустройствами; Для них значение этого элемента равно 2.

Предполагается, что канал 1 является левым каналом; Предполагается, что канал 2 является правильным каналом.

С многоканальной линией может быть связан один или несколько однородных элементов управления (элементов управления, которые одинаково влияют на все каналы линии).

cConnections

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

cControls

Количество элементов управления, связанных с звуковой строкой. Это значение может быть равно 0. Если с строкой не связаны никакие элементы управления, скорее всего, строка будет источником, который может быть выбран в MIXERCONTROL_CONTROLTYPE_MUX или MIXERCONTROL_CONTROLTYPE_MIXER но не позволяет управлять сигналом.

szShortName[MIXER_SHORT_NAME_CHARS]

Короткая строка, описывающая строку аудио микшера, указанную в элементе dwLineID . Это описание должно быть уместным в виде краткой метки для строки.

szName[MIXER_LONG_NAME_CHARS]

Строка, описывающая строку аудио микшера, указанную в элементе dwLineID . Это описание должно быть уместным в качестве полного описания строки.

Target

Целевая информация о мультимедиа.

Target.dwType

Целевой тип устройства мультимедиа, связанный с звуковой линией, описанной в структуре MIXERLINE . Приложение должно игнорировать сведения о целевом объекте для типов устройств мультимедиа, которые оно не использует. Определяются следующие значения:

Имя	Описание
MIXERLINE_TARGETTYPE_AUX	Звуковая линия, описанная структурой MIXERLINE , строго привязана к вспомогательному устройству, подробно описанному в остальных членах целевой структуры структуры MIXERLINE .
MIXERLINE_TARGETTYPE_MIDIIN	Звуковая строка, описанная структурой MIXERLINE , строго привязана к устройству ввода MIDI, подробно описанному в остальных членах целевой структуры структуры MIXERLINE .
MIXERLINE_TARGETTYPE_MIDIOUT	Звуковая линия, описанная структурой MIXERLINE , строго привязана к устройству вывода MIDI, подробно описанному в остальных членах целевой структуры структуры MIXERLINE .
MIXERLINE_TARGETTYPE_UNDEFINED	Звуковая линия, описанная структурой MIXERLINE , не привязана строго к определенному типу мультимедиа. Все оставшиеся элементы целевой структуры структуры MIXERLINE следует игнорировать. Приложение не может использовать целевой тип MIXERLINE_TARGETTYPE_UNDEFINED при вызове функции mixerGetLineInfo с флагом MIXER_GETLINEINFOF_TARGETTYPE.
MIXERLINE_TARGETTYPE_WAVEIN	Звуковая линия, описанная структурой MIXERLINE , строго привязана к устройству ввода waveform-audio, подробно описанному в остальных членах целевой структуры структуры MIXERLINE .
MIXERLINE_TARGETTYPE_WAVEOUT	Звуковая линия, описанная структурой MIXERLINE , строго привязана к устройству вывода waveform-audio, подробно описанному в остальных членах структуры Target структуры MIXERLINE .

Target.dwDeviceID

Текущий идентификатор устройства целевого мультимедийного устройства, когда член dwType является целевым типом, отличным от MIXERLINE_TARGETTYPE_UNDEFINED. Этот идентификатор идентичен текущему индексу устройства мультимедиа связанного мультимедийного устройства. При вызове функции mixerGetLineInfo с флагом MIXER_GETLINEINFOF_TARGETTYPE этот элемент игнорируется при входе и будет возвращен вызывающей стороне диспетчером аудио микшера.

Target.wMid

Идентификатор производителя целевого мультимедийного устройства, если элемент dwType является целевым типом, отличным от MIXERLINE_TARGETTYPE_UNDEFINED. Этот идентификатор идентичен члену wMid структуры device-capabilities для связанного носителя. Идентификаторы изготовителей определяются в полях Идентификаторы производителя и Продукта.

Target.wPid

Идентификатор продукта целевого устройства мультимедиа, если элемент dwType является целевым типом, отличным от MIXERLINE_TARGETTYPE_UNDEFINED. Этот идентификатор идентичен члену wPid структуры device-capabilities для связанного носителя. Идентификаторы продуктов определяются в полях "Изготовитель" и "Идентификаторы продуктов".

Target.vDriverVersion

Версия драйвера целевого мультимедийного устройства, когда член dwType является целевым типом, отличным от MIXERLINE_TARGETTYPE_UNDEFINED. Эта версия идентична члену vDriverVersion структуры device-capabilities для связанного носителя.

Target.szPname[MAXPNAMELEN]

Название продукта целевого мультимедийного устройства, если член dwType является целевым типом, отличным от MIXERLINE_TARGETTYPE_UNDEFINED. Это имя идентично члену szPname структуры device-capabilities для связанного носителя.

Комментарии

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	mmeapi.h

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

Структуры аудио микшера

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

MIXERCAPS

mixerGetDevCaps

mixerGetLineInfo