Membuat fungsiFX (xapofx.h)

Artikel
08/28/2023

Membuat instans efek XAPOFX yang diminta.

Sintaks

FX_API_(HRESULT) CreateFX(
             REFCLSID                clsid,
             IUnknown                **pEffect,
             const void *pInitDat    DEFAULT,
             UINT32 InitDataByteSize DEFAULT
);

Parameter

clsid

ID efek yang akan dibuat. Gunakan __uuidof pada nama kelas efek untuk mendapatkan CLSID untuk efek. Misalnya, __uuidof(FXReverb) akan memberikan CLSID untuk efek FXReverb. Untuk daftar efek yang disediakan oleh XAPOFX, lihat Gambaran Umum XAPOFX. Untuk contoh mengambil CLSID untuk efek, lihat Cara: Menggunakan XAPOFX di XAudio2.

pEffect

Menerima pointer ke instans XAPO yang dibuat. Jika CreateFX gagal, pEffect tidak tersentuh.

DEFAULT

Nilai kembali

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

XAPO yang dibuat akan memiliki jumlah referensi 1. Kode klien harus memanggil IUnknown::Release setelah meneruskan XAPO ke XAudio2 untuk memungkinkan XAudio2 membuang XAPO ketika tidak lagi diperlukan. Gunakan IXAudio2::CreateSourceVoice atau IXAudio2Voice::SetEffectChain untuk meneruskan XAPO ke XAudio2.

Catatan Versi DirectX SDK dari fungsi ini tidak memiliki parameter pInitData atau InitDataByteSize karena hanya mengambil 2 parameter pertama. Untuk mengatur parameter awal untuk efek XAPOFX yang dibuat dengan versi DirectX SDK dari fungsi ini, Anda harus mengikat efek tersebut ke suara dan menggunakan IXAudio2Voice::SetEffectParameters. Untuk informasi tentang cara melakukannya, lihat Cara: Menggunakan XAPOFX di XAudio2.

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	xapofx.h
Pustaka	XAudio.lib
DLL	Windows.Media.Audio.dll

Lihat juga

Fungsi

Bagikan melalui