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

Статья
11/20/2024

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

Синтаксис

MMRESULT midiInGetDevCapsA(
  UINT_PTR      uDeviceID,
  LPMIDIINCAPSA pmic,
  UINT          cbmic
);

Параметры

uDeviceID

Идентификатор устройства ввода MIDI. Идентификатор устройства зависит от нуля до одного, чем число присутствующих устройств. Этот параметр также может быть правильным дескриптором устройства.

pmic

Указатель на структуру MIDIINCAPS, заполненную информацией о возможностях устройства.

cbmic

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

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

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

Возвращаемый код	Описание
MMSYSERR_BADDEVICEID	Указанный идентификатор устройства выходит за пределы диапазона.
MMSYSERR_INVALPARAM	Указанный указатель или структура недопустимы.
MMSYSERR_NODRIVER	Драйвер не установлен.
MMSYSERR_NOMEM	Система не может выделить или заблокировать память.

Замечания

Чтобы определить количество устройств ввода MIDI, присутствующих в системе, используйте функцию midiInGetNumDevs.

Заметка

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

Требования

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

См. также

функции MIDI

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