Share via

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