Struktur WAVEHDR (mmeapi.h)

Artikel
02/29/2024

Struktur WAVEHDR mendefinisikan header yang digunakan untuk mengidentifikasi buffer waveform-audio.

Sintaks

typedef struct wavehdr_tag {
  LPSTR              lpData;
  DWORD              dwBufferLength;
  DWORD              dwBytesRecorded;
  DWORD_PTR          dwUser;
  DWORD              dwFlags;
  DWORD              dwLoops;
  struct wavehdr_tag *lpNext;
  DWORD_PTR          reserved;
} WAVEHDR, *PWAVEHDR, *NPWAVEHDR, *LPWAVEHDR;

Anggota

lpData

Arahkan ke buffer bentuk gelombang.

dwBufferLength

Panjang, dalam byte, dari buffer.

dwBytesRecorded

Saat header digunakan dalam input, menentukan berapa banyak data dalam buffer.

dwUser

Data pengguna.

dwFlags

Bitwise OR dari nol atau lebih bendera. Bendera berikut didefinisikan:

Nama	Deskripsi
WHDR_BEGINLOOP	Buffer ini adalah buffer pertama dalam perulangan. Bendera ini hanya digunakan dengan buffer output.
WHDR_DONE	Atur oleh driver perangkat untuk menunjukkan bahwa itu selesai dengan buffer dan mengembalikannya ke aplikasi.
WHDR_ENDLOOP	Buffer ini adalah buffer terakhir dalam perulangan. Bendera ini hanya digunakan dengan buffer output.
WHDR_INQUEUE	Atur oleh Windows untuk menunjukkan bahwa buffer diantrekan untuk pemutaran.
WHDR_PREPARED	Atur oleh Windows untuk menunjukkan bahwa buffer telah disiapkan dengan fungsi waveInPrepareHeader atau waveOutPrepareHeader .

dwLoops

Berapa kali untuk memutar perulangan. Anggota ini hanya digunakan dengan buffer output.

lpNext

Dicadangkan.

reserved

Dicadangkan.

Keterangan

Gunakan bendera WHDR_BEGINLOOP dan WHDR_ENDLOOP di anggota dwFlags untuk menentukan blok data awal dan akhir untuk perulangan. Untuk mengulang pada satu blok, tentukan kedua bendera untuk blok yang sama. Gunakan anggota dwLoops dalam struktur WAVEHDR untuk blok pertama dalam perulangan untuk menentukan berapa kali memutar perulangan.

Anggota lpData, dwBufferLength, dan dwFlags harus diatur sebelum memanggil fungsi waveInPrepareHeader atau waveOutPrepareHeader . (Untuk salah satu fungsi, anggota dwFlags harus diatur ke nol.)

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	mmeapi.h (termasuk Windows.h)

Lihat juga

Waveform Audio

Struktur Bentuk Gelombang

waveInPrepareHeader

waveOutPrepareHeader

Bagikan melalui