Структура MIDIOUTCAPSA (mmeapi.h)

Статья
11/20/2024

Структура MIDIOUTCAPS описывает возможности выходного устройства MIDI.

Синтаксис

typedef struct tagMIDIOUTCAPSA {
  WORD      wMid;
  WORD      wPid;
  MMVERSION vDriverVersion;
  CHAR      szPname[MAXPNAMELEN];
  WORD      wTechnology;
  WORD      wVoices;
  WORD      wNotes;
  WORD      wChannelMask;
  DWORD     dwSupport;
} MIDIOUTCAPSA, *PMIDIOUTCAPSA, *NPMIDIOUTCAPSA, *LPMIDIOUTCAPSA;

Члены

wMid

Идентификатор производителя драйвера устройства для выходного устройства MIDI. Идентификаторы изготовителя определяются в изготовителя и идентификаторов продуктов.

wPid

Идентификатор продукта выходного устройства MIDI. Идентификаторы продуктов определяются в изготовителя и идентификаторов продуктов.

vDriverVersion

Номер версии драйвера устройства для выходного устройства MIDI. Байт высокого порядка — это основной номер версии, а байт низкого порядка — это дополнительный номер версии.

szPname[MAXPNAMELEN]

Имя продукта в строке, завершаемой значением NULL.

wTechnology

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

Имя	Описание
MOD_MIDIPORT	Аппаратный порт MIDI.
MOD_SYNTH	Синтезатор.
MOD_SQSYNTH	Синтезатор квадратной волны.
MOD_FMSYNTH	Синтезатор FM.
MOD_MAPPER	Microsoft MIDI mapper.
MOD_WAVETABLE	Аппаратный синтезатор волны.
MOD_SWSYNTH	Синтезатор программного обеспечения.

wVoices

Количество голосов, поддерживаемых внутренним синтезатором устройства. Если устройство является портом, этот элемент не имеет значения и имеет значение 0.

wNotes

Максимальное количество одновременных заметок, которое может воспроизводиться внутренним синтезатором. Если устройство является портом, этот элемент не имеет значения и имеет значение 0.

wChannelMask

Каналы, на которые отвечает внутреннее устройство синтезатора, где наименее значительный бит относится к каналу 0 и наиболее значительным битом к каналу 15. Устройства портов, передаваемые во всех каналах, задают для этого элемента значение 0xFFFF.

dwSupport

Необязательные функции, поддерживаемые устройством. Это может быть одно или несколько следующих элементов:

Имя	Описание
MIDICAPS_CACHE	Поддерживает кэширование исправлений.
MIDICAPS_LRVOLUME	Поддерживает отдельный левый и правый элемент управления томом.
MIDICAPS_STREAM	Предоставляет прямую поддержку функции midiStreamOut.
MIDICAPS_VOLUME	Поддерживает управление томами.

Если устройство поддерживает изменение тома, флаг MIDICAPS_VOLUME будет установлен для члена dwSupport. Если устройство поддерживает отдельные изменения тома в левых и правых каналах, для этого элемента будут заданы MIDICAPS_VOLUME и флаги MIDICAPS_LRVOLUME.

Замечания

Заметка

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

Требования

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

См. также

структуры MIDI

цифровой интерфейс музыкального инструмента (MIDI)

midiStreamOut

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