MIDIOUTCAPSA 结构 (mmeapi.h)

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 映射器。
MOD_WAVETABLE
硬件可波式合成器。
MOD_SWSYNTH
软件合成器。

wVoices

内部合成器设备支持的语音数。 如果设备是端口,则此成员没有意义,并且设置为 0。

wNotes

内部合成器设备可以播放的最大同时笔记数。 如果设备是端口,则此成员没有意义,并且设置为 0。

wChannelMask

内部合成器设备响应的通道,其中最小有效位是指通道 0 和通道 15 的最有效位。 在所有通道上传输的端口设备将此成员设置为0xFFFF。

dwSupport

设备支持的可选功能。 它可以是以下一个或多个:

名字 描述
MIDICAPS_CACHE
支持修补程序缓存。
MIDICAPS_LRVOLUME
支持单独的左右音量控制。
MIDICAPS_STREAM
提供对 midiStreamOut 函数 的直接支持。
MIDICAPS_VOLUME
支持音量控制。
 

如果设备支持卷更改,则会为 dwSupport 成员设置MIDICAPS_VOLUME标志。 如果设备支持左侧和右侧通道上的单独卷更改,则会为此成员设置MIDICAPS_VOLUME和MIDICAPS_LRVOLUME标志。

言论

注意

mmeapi.h 标头将 MIDIOUTCAPS 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
标头 mmeapi.h (包括 Windows.h)

另请参阅

MIDI 结构

乐器数字界面(MIDI)

midiStreamOut