midiOutShortMsg (mmeapi.h)
Fungsi midiOutShortMsg mengirimkan pesan MIDI singkat ke perangkat output MIDI yang ditentukan.
Sintaks
MMRESULT midiOutShortMsg(
HMIDIOUT hmo,
DWORD dwMsg
);
Parameter
hmo
Tangani ke perangkat output MIDI. Parameter ini juga dapat menjadi penanganan transmisi aliran MIDI ke HMIDIOUT.
dwMsg
Pesan MIDI. Pesan dikemas ke dalam nilai DWORD dengan byte pertama pesan dalam byte berurutan rendah. Pesan dikemas ke dalam parameter ini sebagai berikut.
| Word | Byte | Penggunaan |
|---|---|---|
| Tinggi | Urutan tinggi | Tidak digunakan. |
| Urutan rendah | Byte kedua data MIDI (jika diperlukan). | |
| Rendah | Urutan tinggi | Byte pertama data MIDI (jika diperlukan). |
| Urutan rendah | Status MIDI. |
Dua byte data MIDI bersifat opsional, tergantung pada byte status MIDI. Saat serangkaian pesan memiliki byte status yang sama, byte status dapat dihilangkan dari pesan setelah pesan pertama dalam seri, membuat status berjalan. Kemas pesan untuk menjalankan status sebagai berikut:
| Word | Byte | Penggunaan |
|---|---|---|
| Tinggi | Urutan tinggi | Tidak digunakan. |
| Urutan rendah | Tidak digunakan. | |
| Rendah | Urutan tinggi | Byte kedua data MIDI (jika diperlukan). |
| Urutan rendah | Byte pertama data MIDI. |
Nilai kembali
Mengembalikan MMSYSERR_NOERROR jika berhasil atau kesalahan sebaliknya. Nilai kesalahan yang mungkin mencakup yang berikut ini:
| Menampilkan kode | Deskripsi |
|---|---|
|
Aplikasi mengirim pesan tanpa byte status ke handel aliran. |
|
Perangkat keras sibuk dengan data lain. |
|
Handel perangkat yang ditentukan tidak valid. |
Keterangan
Fungsi ini digunakan untuk mengirim pesan MIDI apa pun kecuali untuk pesan eksklusif sistem atau streaming.
Fungsi ini mungkin tidak kembali sampai pesan dikirim ke perangkat output. Anda dapat mengirim pesan singkat saat streaming diputar di perangkat yang sama (meskipun Anda tidak dapat menggunakan status berjalan dalam kasus ini).
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | mmeapi.h (termasuk Windows.h) |
| Pustaka | Winmm.lib |
| DLL | Winmm.dll |