midiStreamProperty 函数 (mmeapi.h)
midiStreamProperty 函数设置或检索与 MIDI 输出设备关联的 MIDI 数据流的属性。
语法
MMRESULT midiStreamProperty(
HMIDISTRM hms,
LPBYTE lppropdata,
DWORD dwProperty
);
参数
hms
与 属性关联的 MIDI 设备的句柄。
lppropdata
指向属性数据的指针。
dwProperty
指定要执行的操作和标识 MIDI 数据流的相应属性的标志。 midiStreamProperty 函数需要在每次使用中设置两个标志。 一个标志 (MIDIPROP_GET或MIDIPROP_SET) 指定操作，另一个标志标识要检查或编辑的特定属性。
| 值 | 含义 |
|---|---|
| MIDIPROP_GET | 检索给定属性的当前设置。 |
| MIDIPROP_SET | 设置给定属性。 |
| MIDIPROP_TEMPO | 检索 tempo 属性。 lppropdata 参数指向 MIDIPROPTEMPO 结构。 可以随时检索当前节奏值。 输出设备通过将MEVT_TEMPO事件插入到 MIDI 数据中来设置节奏。 |
| MIDIPROP_TIMEDIV | 指定时分属性。 可以获取或设置此属性。 lppropdata 参数指向 MIDIPROPTIMEDIV 结构。 仅当设备停止时，才能设置此属性。 |
返回值
如果成功，则返回MMSYSERR_NOERROR，否则返回错误。 可能的错误值包括以下内容。
| 返回代码 | 说明 |
|---|---|
|
指定的句柄不是流句柄。 |
|
给定的句柄或标志参数无效。 |
注解
这些属性是系统定义的默认属性。 驱动程序编写器可以实现并记录其自己的属性。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | mmeapi.h (包括 Windows.h) |
| Library | Winmm.lib |
| DLL | Winmm.dll |