функция mixerGetLineInfoA (mmeapi.h)

Статья
11/20/2024

Функция mixerGetLineInfo извлекает сведения о конкретной строке устройства миксера.

Синтаксис

MMRESULT mixerGetLineInfoA(
  HMIXEROBJ    hmxobj,
  LPMIXERLINEA pmxl,
  DWORD        fdwInfo
);

Параметры

hmxobj

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

pmxl

Указатель на структуру MIXERLINE. Эта структура заполнена информацией о звуковой строке для устройства микшера. Элемент cbStruct всегда должен быть инициализирован для размера в байтах структуры MIXERLINE.

fdwInfo

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

Ценность	Значение
MIXER_GETLINEINFOF_COMPONENTTYPE	Параметр pmxl получит сведения о первой звуковой строке типа, указанного в элементе dwComponentType структуры MIXERLINE. Этот флаг используется для получения сведений о звуковой строке определенного типа компонента. Оставшиеся элементы структуры, кроме cbStruct не требуют дальнейшей инициализации.
MIXER_GETLINEINFOF_DESTINATION	Параметр pmxl получит сведения о целевой звуковой строке, указанной dwDestination элементом структуры MIXERLINE. Этот индекс диапазон от нуля до одного меньше значения в cDestinations член структуры MIXERCAPS. Все оставшиеся элементы структуры, кроме cbStruct не требуют дальнейшей инициализации.
MIXER_GETLINEINFOF_LINEID	Параметр pmxl получит сведения о звуковой строке, указанной dwLineID членом структуры MIXERLINE. Обычно это используется для получения обновленных сведений о состоянии звуковой линии. Все оставшиеся элементы структуры, кроме cbStruct не требуют дальнейшей инициализации.
MIXER_GETLINEINFOF_SOURCE	Параметр pmxl получит сведения о исходной звуковой строке, указанной dwDestination и dwSource членов структуры MIXERLINE. Индекс, указанный в dwDestination диапазон от нуля до одного, чем значение в cDestinations член структуры MIXERCAPS. Индекс, указанный dwSource диапазон от нуля до одного меньше, чем значение в cConnections член структуры MIXERLINE, возвращаемой для звуковой строки, хранящейся в элементе dwDestination. Все оставшиеся элементы структуры, кроме cbStruct не требуют дальнейшей инициализации.
MIXER_GETLINEINFOF_TARGETTYPE	Параметр pmxl получит сведения о звуковой строке, которая относится к элементу dwType структуры Target, которая входит в структуру MIXERLINE. Этот флаг используется для получения сведений о звуковой строке, которая обрабатывает тип целевого объекта (например, MIXERLINE_TARGETTYPE_WAVEOUT). Приложение должно инициализировать dwType, wMid, wPid, vDriverVersion и szPname членов структуры MIXERLINE перед вызовом mixerGetLineInfo. Все эти значения можно получить из структур возможностей устройства для всех устройств мультимедиа. Оставшиеся элементы структуры, кроме cbStruct не требуют дальнейшей инициализации. примечание в версии этой функции ANSI (mixerGetLineInfoA), нельзя использовать строку ANSI, возвращаемую из mixerGetLineInfo или waveOutGetDevCaps для значения строки psPname при вызове mixerGetLineInfo с флагом MIXER_GETLINEINFOF_TARGETTYPE. Причина заключается в том, что выполняется внутреннее преобразование в Юникод и из нее, что может привести к потере данных.
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 — это дескриптор входных данных waveform-audio, возвращаемый функцией 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_INVALLINE	Ссылка на аудиолайн является недопустимой.
MMSYSERR_BADDEVICEID	Параметр hmxobj указывает недопустимый идентификатор устройства.
MMSYSERR_INVALFLAG	Один или несколько флагов недопустимы.
MMSYSERR_INVALHANDLE	Параметр hmxobj указывает недопустимый дескриптор.
MMSYSERR_INVALPARAM	Один или несколько параметров недопустимы.
MMSYSERR_NODRIVER	Для объекта, указанного hmxobj, не доступно устройство миксера.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	mmeapi.h (включая Windows.h)
библиотеки	Winmm.lib
DLL	Winmm.dll

См. также

функции Миксера звука

звуковых миксеров

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