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

Статья
11/20/2024

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

Синтаксис

MMRESULT midiOutGetDevCapsW(
  UINT_PTR       uDeviceID,
  LPMIDIOUTCAPSW pmoc,
  UINT           cbmoc
);

Параметры

uDeviceID

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

Этот параметр также может быть правильным дескриптором устройства.

pmoc

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

cbmoc

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

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

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

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

Замечания

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

Заметка

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

Требования

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

См. также

функции MIDI

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