通过

midiOutGetDevCapsW 函数 （mmeapi.h）

  • 项目

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

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 mmeapi.h （包括 Windows.h）
库 Winmm.lib
DLL Winmm.dll

另请参阅

MIDI 函数