MODM_UNPREPARE 函数
WINMM 将 MODM_UNPREPARE
消息发送到 MIDI 输出驱动程序的 modMessage 函数,以清理由 MODM_PREPARE 配置的内存段。
语法
DWORD modMessage(
UINT uDeviceID,
UINT uMsg,
DWORD_PTR dwUser,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2
);
参数
uDeviceID
指定目标设备的 ID。 设备 ID 将按顺序,其初始值为零,最终值等于比驱动程序支持的设备数小一。uMsg
在调用 modMessage 来处理此消息时,WINMM 会将此参数设置为 MODM_UNPREPAE。dwUser
使用此参数可将实例数据返回到驱动程序。 支持多个客户端的驱动程序可以使用此类实例数据跟踪与消息关联的客户端。dwParam1
指定指向用于标识数据块的 MIDIHDR 结构的远指针。dwParam2
指定 MIDIHDR 结构的大小。
返回值
如果操作成功,modMEssage 函数将返回 MMSYSERR_NOERROR。 否则,它将返回 MMSYSERR_NOTENABLED,以指示驱动程序无法加载或初始化。
注解
此消息的驱动程序支持为可选。 如果驱动程序支持 MODM_PREPARE 消息,则它还必须支持 MODM_UNPREPARE
。
此消息的默认响应是返回 MMSYSERR_NOTSUPPORTED。 在这种情况下,Mmsystem.dll 会清理之前在内存块上完成的准备。 如果驱动程序执行 PREPARE 操作,则必须清理准备,并在 MIDIHDR 结构的 dwFlags 字段中重置 MHDR_PREPARED 标志。
要求
目标平台 |
桌面 |
版本 |
适用于 Windows XP 及更高版本的 Windows 操作系统。 |
标头 |
Mmddk.h(包括 Mmddk.h、Mmsystem.h 或 Windows.h) |