Metode IXAudio2SourceVoice::SetFrequencyRatio (xaudio2.h)
Mengatur rasio penyesuaian frekuensi suara.
Sintaks
HRESULT SetFrequencyRatio(
[in] float Ratio,
[in] UINT32 OperationSet
);
Parameter
[in] Ratio
Rasio penyesuaian frekuensi. Nilai ini harus antara XAUDIO2_MIN_FREQ_RATIO dan parameter MaxFrequencyRatio yang ditentukan saat suara dibuat (lihat IXAudio2::CreateSourceVoice). XAUDIO2_MIN_FREQ_RATIO saat ini adalah 0,0005, yang memungkinkan pitch diturunkan hingga 11 oktaf.
[in] OperationSet
Mengidentifikasi panggilan ini sebagai bagian dari batch yang ditangguhkan. Lihat gambaran umum XAudio2 Operation Sets untuk informasi selengkapnya.
Nilai kembali
Mengembalikan S_OK jika berhasil, kode kesalahan sebaliknya. Lihat Kode Kesalahan XAudio2 untuk deskripsi kode kesalahan.
Keterangan
Penyesuaian frekuensi dinyatakan sebagaifrekuensi targetfrekuensi / sumber. Mengubah rasio frekuensi mengubah kecepatan audio diputar pada suara. Rasio yang lebih besar dari 1,0 akan menyebabkan audio diputar lebih cepat dan rasio kurang dari 1,0 akan menyebabkan audio diputar lebih lambat. Selain itu, rasio frekuensi memengaruhi nada audio pada suara. Sebagai contoh, nilai 1,0 tidak berpengaruh pada audio, sedangkan nilai 2,0 menaikkan pitch satu oktaf dan 0,5 menurunkannya satu oktaf.
Jika SetFrequencyRatio disebut menentukan nilai Rasio di luar rentang yang valid, metode akan mengatur rasio frekuensi ke nilai valid terdekat. Peringatan juga akan dibuat untuk build debug.
Persyaratan Platform
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | xaudio2.h |