fungsi midiStreamOpen (mmeapi.h)

Artikel
08/24/2023

Fungsi midiStreamOpen membuka aliran MIDI untuk output. Secara default, perangkat dibuka dalam mode dijeda. Handel aliran yang diambil oleh fungsi ini harus digunakan di semua referensi berikutnya ke aliran.

Sintaks

MMRESULT midiStreamOpen(
  LPHMIDISTRM phms,
  LPUINT      puDeviceID,
  DWORD       cMidi,
  DWORD_PTR   dwCallback,
  DWORD_PTR   dwInstance,
  DWORD       fdwOpen
);

Parameter

phms

Penunjuk ke variabel untuk berisi handel aliran saat fungsi kembali.

puDeviceID

Penunjuk ke pengidentifikasi perangkat. Perangkat dibuka atas nama aliran dan ditutup lagi saat aliran ditutup.

cMidi

Dipesan; harus 1.

dwCallback

Penunjuk ke fungsi panggilan balik, handel peristiwa, pengidentifikasi utas, atau handel jendela atau utas yang dipanggil selama pemutaran MIDI untuk memproses pesan yang terkait dengan kemajuan pemutaran. Jika tidak ada mekanisme panggilan balik yang diinginkan, tentukan NULL untuk parameter ini.

dwInstance

Data instans khusus aplikasi yang dikembalikan ke aplikasi dengan setiap fungsi panggilan balik.

fdwOpen

Bendera panggilan balik untuk membuka perangkat. Salah satu bendera panggilan balik berikut harus ditentukan.

Nilai	Makna
CALLBACK_EVENT	Parameter dwCallback adalah handel peristiwa. Mekanisme panggilan balik ini hanya untuk output.
CALLBACK_FUNCTION	Parameter dwCallback adalah alamat prosedur panggilan balik. Untuk tanda tangan panggilan balik, lihat MidiOutProc.
CALLBACK_NULL	Tidak ada mekanisme panggilan balik. Ini adalah pengaturan default.
CALLBACK_THREAD	Parameter dwCallback adalah pengidentifikasi utas.
CALLBACK_WINDOW	Parameter dwCallback adalah handel jendela.

Mengembalikan nilai

Mengembalikan MMSYSERR_NOERROR jika berhasil atau kesalahan sebaliknya. Kemungkinan nilai kesalahan termasuk yang berikut ini.

Menampilkan kode	Deskripsi
MMSYSERR_BADDEVICEID	Pengidentifikasi perangkat yang ditentukan berada di luar rentang.
MMSYSERR_INVALPARAM	Parameter handel atau bendera yang diberikan tidak valid.
MMSYSERR_NOMEM	Sistem tak bisa mengalokasikan atau mengunci memori.

Persyaratan


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

Lihat juga

Fungsi MIDI

Bagikan melalui