fungsi waveOutPrepareHeader (mmeapi.h)

Fungsi waveOutPrepareHeader menyiapkan blok data waveform-audio untuk pemutaran.

Sintaks

MMRESULT waveOutPrepareHeader(
  HWAVEOUT  hwo,
  LPWAVEHDR pwh,
  UINT      cbwh
);

Parameter

hwo

Tangani ke perangkat output waveform-audio.

pwh

Penunjuk ke struktur WAVEHDR yang mengidentifikasi blok data yang akan disiapkan.

cbwh

Ukuran, dalam byte, dari struktur WAVEHDR .

Menampilkan nilai

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

Menampilkan kode	Deskripsi
MMSYSERR_INVALHANDLE	Handel perangkat yang ditentukan tidak valid.
MMSYSERR_NODRIVER	Tidak ada driver perangkat.
MMSYSERR_NOMEM	Tidak dapat mengalokasikan atau mengunci memori.

Keterangan

Atur anggota lpData, dwBufferLength, dan dwFlags dari struktur WAVEHDR sebelum memanggil fungsi ini. Atur anggota dwFlags ke nol.

Anggota dwFlags, dwBufferLength, dan dwLoops dari struktur WAVEHDR dapat berubah antara panggilan ke fungsi ini dan fungsi waveOutWrite . Jika Anda mengubah ukuran yang ditentukan oleh dwBufferLength sebelum panggilan ke waveOutWrite, nilai baru harus kurang dari nilai yang disiapkan.

Jika metode berhasil, bendera WHDR_PREPARED diatur dalam anggota dwFlags dari struktur WAVEHDR .

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

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 Mmeapi.h, Windows.h)
Pustaka	Winmm.lib
DLL	Winmm.dll

Lihat juga

Audio Bentuk Gelombang

Fungsi Bentuk Gelombang