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

Статья
11/20/2024

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

Синтаксис

MMRESULT mixerGetDevCapsW(
  UINT_PTR     uMxId,
  LPMIXERCAPSW 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.

Заметка

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

Требования

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

См. также

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

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

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