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。 可能的錯誤值包括下列專案。
| 傳回碼 | Description |
|---|---|
|
指定的句柄不是數據流句柄。 |
|
指定的句柄或旗標參數無效。 |
備註
這些屬性是由系統定義的預設屬性。 驅動程式寫入器可以實作並記錄自己的屬性。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mmeapi.h (包含 Windows.h) |
| 程式庫 | Winmm.lib |
| Dll | Winmm.dll |