Metode IXAudio2Voice::SetFilterParameters (xaudio2.h)
Mengatur parameter filter suara.
Sintaks
\\HRESULT SetFilterParameters(
[in] const XAUDIO2_FILTER_PARAMETERS *pParameters,
[in] UINT32 OperationSet
);
Parameter
[in] pParameters
Penunjuk ke struktur XAUDIO2_FILTER_PARAMETERS yang berisi informasi filter.
[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
SetFilterParameters akan gagal jika suara tidak dibuat dengan bendera XAUDIO2_VOICE_USEFILTER.
Metode ini hanya dapat digunakan pada suara sumber dan submix dan tidak berpengaruh pada penguasaan suara.
CatatanIXAudio2Voice::GetFilterParameters selalu mengembalikan parameter filter suara saat ini yang sebenarnya. Namun, ini mungkin tidak cocok dengan parameter yang ditetapkan oleh panggilan IXAudio2Voice::SetFilterParameters terbaru: parameter aktual hanya diubah saat mesin audio berjalan setelah panggilan IXAudio2Voice::SetFilterParameters (atau setelah panggilan IXAudio2::CommitChanges yang sesuai, jika IXAudio2Voice::SetFilterParameters 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 |