fungsi waveInUnprepareHeader (mmeapi.h)

Fungsi waveInUnprepareHeader membersihkan persiapan yang dilakukan oleh fungsi waveInPrepareHeader . Fungsi ini harus dipanggil setelah driver perangkat mengisi buffer dan mengembalikannya ke aplikasi. Anda harus memanggil fungsi ini sebelum membebaskan buffer.

Sintaks

MMRESULT waveInUnprepareHeader(
  HWAVEIN   hwi,
  LPWAVEHDR pwh,
  UINT      cbwh
);

Parameter

hwi

Tangani ke perangkat input waveform-audio.

pwh

Penunjuk ke struktur WAVEHDR yang mengidentifikasi buffer yang akan dibersihkan.

cbwh

Ukuran, dalam byte, dari struktur WAVEHDR .

Nilai kembali

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

Keterangan

Fungsi ini melengkapi fungsi waveInPrepareHeader .

Anda harus memanggil fungsi ini sebelum membebaskan buffer. Setelah meneruskan buffer ke driver perangkat dengan fungsi waveInAddBuffer , Anda harus menunggu sampai driver selesai dengan buffer sebelum memanggil waveInUnprepareHeader. Tidak menyiapkan buffer yang belum disiapkan tidak berpengaruh, dan fungsi mengembalikan nol.

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

Audio Bentuk Gelombang

Fungsi Bentuk Gelombang