MODM_PROPERTIES 函数

  • 项目

WINMM 将 MODM_PROPERTIES 消息发送到 MIDI 输出驱动程序的 modMessage 函数，以更改输出流的属性。

语法

DWORD modMessage(
   UINT      uDeviceID,
   UINT      uMsg,
   DWORD_PTR dwUser,
   DWORD_PTR dwParam1,
   DWORD_PTR dwParam2
);

参数

  • uDeviceID
    指定目标设备的 ID。 设备 ID 将按顺序，其初始值为零，最终值等于比驱动程序支持的设备数小一。

  • uMsg
    在调用 modMessage 来处理此消息时，WINMM 会将此参数设置为 MODM_PROPERTIES。

  • dwUser
    使用此参数可将实例数据返回到驱动程序。 支持多个客户端的驱动程序可以使用此类实例数据跟踪与消息关联的客户端。

  • dwParam1
    包含指向包含有关流的信息的结构的远指针。

  • dwParam2
    包含指定操作和属性的标志。 属性标志在值的低 30 位中设置。 这些属性位可与下表中的其中一个标志结合使用，方法是使用逻辑 OR 运算符。

    标记 含义

    MIDIPROP_SET

    指示驱动程序设置指定的属性。

    MIDIPROP_GET

    指示驱动程序读取（获取）指定的属性。

返回值

如果操作成功，modMessage 函数将返回 MMSYSERR_NOERROR。 否则，它将返回下表中的其中一条错误消息。

返回代码 说明
MMSYSERR_NOTENABLED

驱动程序无法加载或初始化。
MMSYSERR_INVALIDPARAM

指定的属性或属性值无效。

注解

有关 MIDI 数据流的属性的详细信息，请参阅 midiStreamProperties。 另请参阅 MIDIPROPTEMPO。

要求

目标平台

 桌面

版本

适用于 Windows XP 及更高版本的 Windows 操作系统。

标头

 Mmddk.h（包括 Mmddk.h、Mmsystem.h 或 Windows.h）

另请参阅

modMessage

midiStreamProperties

MIDIPROPTIMEDIV

MIDIPROPTEMPO