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

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

Синтаксис

typedef struct tMIXERLINE {
  DWORD  cbStruct;
  DWORD  dwDestination;
  DWORD  dwSource;
  DWORD  dwLineID;
  DWORD  fdwLine;
  DWORD  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;
    VERSION vDriverVersion;
    char    szPname[MAXPNAMELEN];
  } Target;
} MIXERLINE, *PMIXERLINE, *LPMIXERLINE;

Члены

cbStruct

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

dwDestination

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

dwSource

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

dwLineID

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

fdwLine

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

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

 

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

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

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

Если строка не может быть строго определена как активная, устройство микшера всегда устанавливает флаг 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	Звуковая линия — это место назначения, которое будет окончательным источником записи для аудиовхода waveform-audio (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) для вывода волнового звука. Большинство звуковых карт для персональных компьютеров предоставляют этот тип компонента в качестве источника для 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 , строго привязана к вспомогательному устройству, подробно описанному в остальных элементах структуры Target структуры MIXERLINE .
MIXERLINE_TARGETTYPE_MIDIIN	Звуковая линия, описанная структурой MIXERLINE , строго привязана к устройству ввода MIDI, описанному в остальных элементах структуры Target структуры MIXERLINE .
MIXERLINE_TARGETTYPE_MIDIOUT	Звуковая линия, описанная структурой MIXERLINE , строго привязана к устройству вывода MIDI, описанному в остальных элементах структуры Target структуры MIXERLINE .
MIXERLINE_TARGETTYPE_UNDEFINED	Звуковая линия, описанная структурой MIXERLINE , не привязана строго к определенному типу мультимедиа. Все оставшиеся элементы целевой структуры структуры MIXERLINE следует игнорировать. Приложение не может использовать целевой тип MIXERLINE_TARGETTYPE_UNDEFINED при вызове функции mixerGetLineInfo с флагом MIXER_GETLINEINFOF_TARGETTYPE.
MIXERLINE_TARGETTYPE_WAVEIN	Звуковая линия, описанная структурой MIXERLINE , строго привязана к устройству ввода звукового сигнала, описанному в остальных элементах структуры Target структуры MIXERLINE .
MIXERLINE_TARGETTYPE_WAVEOUT	Звуковая линия, описанная структурой MIXERLINE , строго привязана к устройству вывода волновой формы и аудио, подробно описанному в остальных элементах структуры 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 для связанного носителя.

Требования

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

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

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

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

MIXERCAPS

mixerGetDevCaps

mixerGetLineInfo