Функция mixerGetID (mmeapi.h)

Статья
08/24/2023

Функция mixerGetID извлекает идентификатор устройства микшера, связанного с указанным дескриптором устройства.

Синтаксис

MMRESULT mixerGetID(
  HMIXEROBJ hmxobj,
  UINT      *puMxId,
  DWORD     fdwId
);

Параметры

hmxobj

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

puMxId

Указатель на переменную, получающую идентификатор устройства микшера. Если для объекта hmxobj нет устройства микшера, в этом расположении помещается значение -1 и возвращается значение ошибки MMSYSERR_NODRIVER.

fdwId

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

Значение	Значение
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 в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:

Код возврата	Описание
MMSYSERR_BADDEVICEID	Параметр hmxobj указывает недопустимый идентификатор устройства.
MMSYSERR_INVALFLAG	Один или несколько флагов недопустимы.
MMSYSERR_INVALHANDLE	Параметр hmxobj указывает недопустимый дескриптор.
MMSYSERR_INVALPARAM	Один или несколько параметров недопустимы.
MMSYSERR_NODRIVER	Для объекта, указанного в hmxobj, отсутствует устройство аудиомиксического микшера. Расположение, на которое ссылается puMxId, также содержит значение -1.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	mmeapi.h (включая Windows.h)
Библиотека	Winmm.lib
DLL	Winmm.dll

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

Функции аудио микшера

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

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