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

Статья
08/24/2023

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

Синтаксис

MMRESULT midiInGetDevCapsW(
  UINT_PTR      uDeviceID,
  LPMIDIINCAPSW pmic,
  UINT          cbmic
);

Параметры

uDeviceID

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

pmic

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

cbmic

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

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

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

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

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

Требования


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

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

Функции MIDI

Share via