Metode IXAudio2SourceVoice::SetFrequencyRatio (xaudio2.h)

Artikel
03/04/2024

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.

CatatanIXAudio2SourceVoice::GetFrequencyRatio selalu mengembalikan rasio frekuensi aktual suara saat ini. Namun, ini mungkin tidak cocok dengan rasio yang ditetapkan oleh panggilan IXAudio2SourceVoice::SetFrequencyRatio terbaru: rasio aktual hanya diubah saat mesin audio berjalan setelah panggilan IXAudio2SourceVoice::SetFrequencyRatio (atau setelah panggilan IXAudio2::CommitChanges yang sesuai, jika IXAudio2SourceVoice::SetFrequencyRatio dipanggil dengan ID operasi yang ditangguhkan).

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

Lihat juga

Cara: Mengubah Pitch Suara

IXAudio2SourceVoice

Bagikan melalui