fungsi waveOutGetPitch (mmeapi.h)
Fungsi waveOutGetPitch mengambil pengaturan nada saat ini untuk perangkat output waveform-audio yang ditentukan.
Sintaks
MMRESULT waveOutGetPitch(
HWAVEOUT hwo,
LPDWORD pdwPitch
);
Parameter
hwo
Tangani ke perangkat output waveform-audio.
pdwPitch
Penunjuk ke variabel yang akan diisi dengan pengaturan pengali nada saat ini. Pengali nada menunjukkan perubahan pitch saat ini dari pengaturan asli yang ditulis. Pengali nada harus berupa nilai positif.
Pengali pitch ditentukan sebagai nilai titik tetap. Kata urutan tinggi dari variabel berisi bagian bilangan bulat yang ditandatangani dari angka tersebut, dan kata berurutan rendah berisi bagian pecahan. Nilai 0x8000 dalam kata berurutan 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.
Menampilkan nilai
Mengembalikan MMSYSERR_NOERROR jika berhasil atau kesalahan sebaliknya. Nilai kesalahan yang mungkin termasuk yang berikut ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
Handel perangkat yang ditentukan tidak valid. |
|
Tidak ada driver perangkat. |
|
Tidak dapat mengalokasikan atau mengunci memori. |
|
Fungsi tidak didukung. |
Keterangan
Mengubah nada tidak mengubah laju pemutaran, laju sampel, atau waktu pemutaran. Tidak semua perangkat mendukung perubahan pitch. Untuk menentukan apakah perangkat mendukung kontrol pitch, gunakan bendera WAVECAPS_PITCH untuk menguji anggota dwSupport struktur WAVEOUTCAPS (diisi oleh fungsi waveOutGetDevCaps ).
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 |