midiOutPrepareHeader (mmeapi.h)

Artikel
05/03/2024

Fungsi midiOutPrepareHeader menyiapkan buffer eksklusif sistem atau streaming MIDI untuk output.

Sintaks

MMRESULT midiOutPrepareHeader(
  HMIDIOUT  hmo,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Parameter

hmo

Tangani ke perangkat output MIDI. Untuk mendapatkan handel perangkat, panggil midiOutOpen. Parameter ini juga dapat menjadi penanganan transmisi aliran MIDI ke jenis HMIDIOUT .

pmh

Arahkan ke struktur MIDIHDR yang mengidentifikasi buffer yang akan disiapkan.

Sebelum memanggil fungsi, atur anggota lpData, dwBufferLength, dan dwFlags dari struktur MIDIHDR . Anggota dwFlags harus diatur ke nol.

cbmh

Ukuran, dalam byte, dari struktur MIDIHDR .

Nilai kembali

Mengembalikan MMSYSERR_NOERROR jika berhasil atau kesalahan sebaliknya. Nilai kesalahan yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
MMSYSERR_INVALHANDLE	Handel perangkat yang ditentukan tidak valid.
MMSYSERR_INVALPARAM	Alamat yang ditentukan tidak valid atau buffer aliran yang diberikan lebih besar dari 64K.
MMSYSERR_NOMEM	Sistem tidak dapat mengalokasikan atau mengunci memori.

Keterangan

Sebelum meneruskan blok data MIDI ke driver perangkat, Anda harus menyiapkan buffer dengan meneruskannya ke fungsi midiOutPrepareHeader . Setelah header disiapkan, jangan ubah buffer. Setelah driver selesai menggunakan buffer, panggil fungsi midiOutUnprepareHeader .

Aplikasi dapat menggunakan kembali buffer yang sama, atau mengalokasikan beberapa buffer dan memanggil midiOutPrepareHeader untuk setiap buffer. Jika Anda menggunakan kembali buffer yang sama, tidak perlu menyiapkan buffer setiap kali. Anda dapat memanggil midiOutPrepareHeader sekali di awal lalu memanggil midiOutUnprepareHeader sekali di akhir.

Buffer aliran tidak boleh lebih besar dari 64K.

Menyiapkan header yang telah disiapkan tidak berpengaruh, dan fungsi mengembalikan MMSYSERR_NOERROR.

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

Lihat juga

Mengalokasikan dan Menyiapkan Blok Data MIDI

Fungsi MIDI

midiOutUnprepareHeader

Bagikan melalui