fungsi waveOutSetPitch (mmeapi.h)

Fungsi waveOutSetPitch mengatur nada untuk perangkat output waveform-audio yang ditentukan.

Sintaks

MMRESULT waveOutSetPitch(
  HWAVEOUT hwo,
  DWORD    dwPitch
);

Parameter

hwo

Tangani ke perangkat output waveform-audio.

dwPitch

Pengaturan pengali pitch baru. Pengaturan ini menunjukkan perubahan nada saat ini dari pengaturan asli yang ditulis. Pengali nada harus berupa nilai positif.

Pengali pitch ditentukan sebagai nilai titik tetap. Kata urutan tinggi berisi bagian bilangan bulat yang ditandatangani dari angka tersebut, dan kata urutan rendah berisi bagian pecahan. Nilai 0x8000 dalam kata urutan rendah mewakili satu setengah, dan 0x4000 mewakili seperempat. Misalnya, nilai 0x00010000 menentukan pengali 1,0 (tanpa perubahan nada), dan nilai 0x000F8000 menentukan pengali 15,5.

Nilai kembali

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

Keterangan

Mengubah pitch tidak mengubah laju pemutaran atau laju sampel, juga tidak mengubah waktu pemutaran. Tidak semua perangkat mendukung perubahan pitch. Untuk menentukan apakah perangkat mendukung kontrol pitch, gunakan bendera WAVECAPS_PITCH untuk menguji anggota dwSupport dari struktur WAVEOUTCAPS (diisi oleh fungsi waveOutGetDevCaps ).

Persyaratan

Lihat juga

Audio Bentuk Gelombang

Fungsi Bentuk Gelombang