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

Функция 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

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

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

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