Функция mixerGetLineInfo (mmeapi.h)
Функция mixerGetLineInfo извлекает сведения об определенной линии микшерного устройства.
Синтаксис
MMRESULT mixerGetLineInfo(
HMIXEROBJ hmxobj,
LPMIXERLINE 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 — это дескриптор вывода waveform-audio, возвращаемый функцией waveOutOpen . |
| MIXER_OBJECTF_MIDIIN | Параметр hmxobj — это идентификатор устройства ввода MIDI. Этот идентификатор должен находиться в диапазоне от нуля до единицы меньше числа устройств, возвращаемых функцией midiInGetNumDevs . |
| MIXER_OBJECTF_MIDIOUT | Параметр hmxobj — это идентификатор устройства вывода MIDI. Этот идентификатор должен находиться в диапазоне от нуля до единицы меньше числа устройств, возвращаемых функцией midiOutGetNumDevs . |
| MIXER_OBJECTF_MIXER | Параметр hmxobj — это идентификатор устройства микшера в диапазоне от нуля до единицы меньше числа устройств, возвращаемых функцией mixerGetNumDevs . Этот флаг является необязательным. |
| MIXER_OBJECTF_WAVEIN | Параметр hmxobj — это идентификатор устройства ввода waveform-audio в диапазоне от нуля до единицы меньше числа устройств, возвращаемых функцией waveInGetNumDevs . |
| MIXER_OBJECTF_WAVEOUT | Параметр hmxobj — это идентификатор устройства вывода waveform-audio в диапазоне от нуля до единицы меньше числа устройств, возвращаемых функцией waveOutGetNumDevs . |
Возвращаемое значение
Возвращает MMSYSERR_NOERROR в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:
| Код возврата | Описание |
|---|---|
|
Недопустимая ссылка на строку звука. |
|
Параметр hmxobj указывает недопустимый идентификатор устройства. |
|
Один или несколько флагов недопустимы. |
|
Параметр hmxobj указывает недопустимый дескриптор. |
|
Один или несколько параметров недопустимы. |
|
Для объекта, указанного в hmxobj, не доступно устройство микшера. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | mmeapi.h (включая Windows.h) |
| Библиотека | Winmm.lib |
| DLL | Winmm.dll |