Metode IXAudio2Voice::SetOutputFilterParameters (xaudio2.h)

Artikel
08/28/2023

Mengatur parameter filter pada salah satu kiriman suara ini.

Sintaks

\\HRESULT SetOutputFilterParameters(
  [in] IXAudio2Voice                   *pDestinationVoice,
  [in] const XAUDIO2_FILTER_PARAMETERS *pParameters,
  [in] UINT32                          OperationSet
);

Parameter

[in] pDestinationVoice

Penunjuk IXAudio2Voice ke suara tujuan kirim yang parameter filternya akan diatur.

[in] pParameters

Arahkan 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.

Menampilkan nilai

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

Keterangan

SetOutputFilterParameters akan gagal jika pengiriman tidak dibuat dengan bendera XAUDIO2_SEND_USEFILTER. Metode ini hanya dapat digunakan pada pengiriman milik suara sumber dan submix dan tidak berpengaruh pada kiriman suara mastering.

CatatanIXAudio2Voice::GetOutputFilterParameters selalu mengembalikan parameter filter pengiriman aktual saat ini. Namun, ini mungkin tidak cocok dengan parameter yang ditetapkan oleh panggilan IXAudio2Voice::SetOutputFilterParameters terbaru: parameter aktual hanya diubah saat mesin audio berjalan setelah panggilan IXAudio2Voice::SetOutputFilterParameters (atau setelah panggilan IXAudio2::CommitChanges yang sesuai, jika IXAudio2Voice::SetOutputFilterParameters 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


Target Platform	Windows
Header	xaudio2.h

Lihat juga

IXAudio2Voice

Bagikan melalui