MODM_RESTART 函数
WINMM 将 MODM_RESTART
消息发送到 MIDI 输出驱动程序的 modMessage 函数,以便在 MODM_PAUSE 之后重启播放。
语法
DWORD modMessage(
UINT uDeviceID,
UINT uMsg,
DWORD_PTR dwUser,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2
);
参数
uDeviceID
指定目标设备的 ID。 设备 ID 将按顺序,其初始值为零,最终值等于比驱动程序支持的设备数小一。uMsg
在调用 modMessage 来处理此消息时,WINMM 会将此参数设置为 MODM_RESTART。dwUser
使用此参数可将实例数据返回到驱动程序。 支持多个客户端的驱动程序可以使用此类实例数据跟踪与消息关联的客户端。dwParam1
未使用。dwParam2
未使用。
返回值
如果操作成功,modMessage 函数将返回 MMSYSERR_NOERROR。 否则,它将返回 MMSYSERR_NOTENABLED,以指示驱动程序无法加载或初始化。
注解
MIDI 输出设备驱动程序必须在当前位置重启 MIDI 播放。
无法嵌套 MODM_PAUSE 和 MODM_RESTART
消息对。 必须忽略驱动程序已处于暂停状态时收到的 MODM_PAUSE 消息;无论收到消息的 MODM_PAUSE 数是多少,播放都将在收到第一条 MODM_RESTART
消息时启动。 同样,必须忽略在驱动程序处于播放模式时收到的 MODM_RESTART
消息。 在任一情况下都必须返回 MMSYSERR_NOERROR。
要求
目标平台 |
桌面 |
版本 |
适用于 Windows XP 及更高版本的 Windows 操作系统。 |
标头 |
Mmddk.h(包括 Mmddk.h、Mmsystem.h 或 Windows.h) |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈