Metode IXAudio2SourceVoice::SetSourceSampleRate (xaudio2.h)

Mengonfigurasi ulang suara untuk mengonsumsi data sumber pada laju sampel yang berbeda dari laju yang ditentukan saat suara dibuat.

Sintaks

HRESULT SetSourceSampleRate(
  [in] UINT32 NewSourceSampleRate
);

Parameter

[in] NewSourceSampleRate

Laju sampel baru tempat suara harus memproses data yang dikirimkan. Laju sampel yang valid adalah 1kHz hingga 200kHz.

Nilai kembali

Mengembalikan S_OK jika berhasil, kode kesalahan sebaliknya. Lihat Kode Kesalahan XAudio2 untuk deskripsi kode kesalahan.

Keterangan

Metode SetSourceSampleRate mendukung penggunaan kembali suara XAudio2 dengan memungkinkan suara untuk memutar suara dengan berbagai laju sampel. Untuk menggunakan SetSourceSampleRate , suara harus dibuat tanpa bendera XAUDIO2_VOICE_NOPITCH atau XAUDIO2_VOICE_NOSRC dan tidak boleh memiliki buffer yang saat ini diantrekan.

Penggunaan umum SetSourceSampleRate adalah untuk mendukung pengumpulan suara. Misalnya untuk mendukung pengumpulan suara aplikasi akan membuat semua suara yang diharapkan untuk digunakan. Setiap kali suara baru akan diputar, aplikasi memilih suara yang tidak aktif atau ,jika semua suara sibuk, memilih suara yang paling tidak penting dan memanggil SetSourceSampleRate pada suara dengan laju sampel suara baru. Setelah SetSourceSampleRate dipanggil pada suara, aplikasi dapat segera mulai mengirimkan dan memutar buffer dengan laju sampel baru. Ini memungkinkan aplikasi untuk menghindari overhead untuk sering membuat dan menghancurkan suara selama gameplay.

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

IXAudio2SourceVoice