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

Функция mixerGetDevCaps запрашивает указанное устройство микшера, чтобы определить его возможности.

Синтаксис

MMRESULT mixerGetDevCaps(
  UINT        uMxId,
  LPMIXERCAPS pmxcaps,
  UINT        cbmxcaps
);

Параметры

uMxId

Идентификатор или дескриптор открытого микшерного устройства.

pmxcaps

Указатель на структуру MIXERCAPS , которая получает сведения о возможностях устройства.

cbmxcaps

Размер структуры MIXERCAPS в байтах .

Возвращаемое значение

Возвращает MMSYSERR_NOERROR в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:

Код возврата	Описание
MMSYSERR_BADDEVICEID	Указанный идентификатор устройства выходит за пределы диапазона.
MMSYSERR_INVALHANDLE	Недопустимый дескриптор устройства микшера.
MMSYSERR_INVALPARAM	Один или несколько параметров недопустимы.

Комментарии

Используйте функцию mixerGetNumDevs , чтобы определить количество устройств микшера, присутствующих в системе. Идентификатор устройства, заданный uMxId , варьируется от нуля до единицы меньше, чем количество присутствующих устройств микшера.

Только количество байтов (или меньше) сведений, указанных в cbmxcaps , копируется в расположение, указанное pmxcaps. Если cbmxcaps равно нулю, ничего не копируется и функция возвращается успешно.

Эта функция также принимает дескриптор устройства микшера, возвращаемый функцией mixerOpen в качестве параметра uMxId . Приложение должно привести дескриптор HMIXER к UINT.

Требования

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

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

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

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