MODM_PAUSE 函数

WINMM 将 MODM_PAUSE 消息发送到 MIDI 输出驱动程序的 modMessage 函数,以暂时暂停输出请求。 流播放停止,但未将任何缓冲区标记为已完成。

语法

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

参数

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

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

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

  • dwParam1
    未使用。

  • dwParam2
    未使用。

返回值

如果操作成功,modMessage 函数将返回 MMSYSERR_NOERROR。 否则,它将返回 MMSYSERR_NOTENABLED,以指示驱动程序无法加载或初始化。

注解

驱动程序必须在当前位置停止 MIDI 播放。 然后,驱动程序必须关闭当前打开的所有注释。

要求

目标平台

桌面

版本

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

标头

Mmddk.h(包括 Mmddk.h、Mmsystem.h 或 Windows.h)

另请参阅

modMessage