fungsi waveOutUnprepareHeader (mmeapi.h)

Fungsi waveOutUnprepareHeader membersihkan persiapan yang dilakukan oleh fungsi waveOutPrepareHeader . Fungsi ini harus dipanggil setelah pengandar perangkat selesai dengan blok data. Anda harus memanggil fungsi ini sebelum membebaskan buffer.

Sintaks

MMRESULT waveOutUnprepareHeader(
  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 dibersihkan.

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.
WAVERR_STILLPLAYING	Blok data yang diarahkan oleh parameter pwh masih dalam antrean.

Keterangan

Fungsi ini melengkapi waveOutPrepareHeader. Anda harus memanggil fungsi ini sebelum membebaskan buffer. Setelah meneruskan buffer ke driver perangkat dengan fungsi waveOutWrite , Anda harus menunggu sampai driver selesai dengan buffer sebelum memanggil waveOutUnprepareHeader.

Tidak menyiapkan buffer yang belum 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 Windows.h)
Pustaka	Winmm.lib
DLL	Winmm.dll

Lihat juga

Audio Bentuk Gelombang

Fungsi Bentuk Gelombang