Bagikan melalui

Fungsi XAudio2CreateReverb (xaudio2fx.h)

  • Artikel

Membuat objek pemrosesan audio gaung baru (APO), dan mengembalikan penunjuk ke objek tersebut.

Sintaks

HRESULT XAudio2CreateReverb(
  [in, out] IUnknown     **ppApo,
  [in]      UINT32 Flags DEFAULT
);

Parameter

[in, out] ppApo

Berisi penunjuk ke APO gaung yang dibuat.

[in] DEFAULT

Bendera yang menentukan perilaku APO. Nilai parameter ini harus 0.

Menampilkan nilai

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

Keterangan

XAudio2CreateReverb menciptakan efek melakukan Princeton Digital Reverb. Pustaka efek XAPO (XAPOFX) menyertakan efek reverb alternatif. Gunakan CreateFX untuk membuat efek alternatif ini.

Dukungan APO reverb memiliki batasan berikut:

  • Data audio input harus FLOAT32.
  • Framerate harus berada dalam XAUDIO2FX_REVERB_MIN_FRAMERATE (20.000 Hz) dan XAUDIO2FX_REVERB_MAX_FRAMERATE (48.000 Hz).
  • Saluran input dan output harus menjadi salah satu kombinasi berikut.
    • Input mono dan output mono
    • Input mono dan output 5.1
    • Input stereo dan output stereo
    • Input stereo dan output 5.1
APO reverb mempertahankan informasi status internal antara sampel pemrosesan. Anda hanya dapat menggunakan instans APO dengan satu sumber data audio pada satu waktu. Beberapa suara yang memerlukan efek gaung masing-masing perlu membuat efek gaung terpisah dengan XAudio2CreateReverb.

Untuk informasi tentang membuat efek baru untuk digunakan dengan XAudio2, lihat Gambaran Umum XAPO.

Windows
Karena XAudio2CreateReverb memanggil CoCreateInstance di Windows, aplikasi harus memanggil metode CoInitializeEx sebelum memanggil XAudio2CreateReverb. XAudio2Create memiliki persyaratan yang sama, yang berarti CoInitializeEx biasanya akan dipanggil jauh sebelum XAudio2CreateReverb dipanggil.

Pola panggilan umum pada Windows adalah sebagai berikut:

#ifndef _XBOX
CoInitializeEx(NULL, COINIT_MULTITHREADED);
#endif
IXAudio2* pXAudio2 = NULL;
HRESULT hr;
if ( FAILED(hr = XAudio2Create( &pXAudio2, 0, XAUDIO2_DEFAULT_PROCESSOR ) ) )
    return hr;
...
IUnknown * pReverbAPO;
XAudio2CreateReverb(&pReverbAPO);
 

Header xaudio2fx.h mendefinisikan GUID kelas AudioReverb sebagai objek pemrosesan audio lintas platform (XAPO).

class __declspec(uuid("C2633B16-471B-4498-B8C5-4F0959E2EC09")) AudioReverb;

XAudio2CreateReverb mengembalikan objek ini sebagai penunjuk ke penunjuk ke IUnknown dalam parameter ppApo . Meskipun Anda dapat mengkueri antarmuka IXAPO dan IXAPOParameters dari IUnknown ini, Anda biasanya tidak pernah menggunakan antarmuka ini secara langsung. Sebagai gantinya, Anda menggunakannya saat membuat suara untuk menambahkannya sebagai bagian dari rantai efek.

Gaung menggunakan struktur parameter XAUDIO2FX_REVERB_PARAMETERS yang Anda akses melalui IXAudio2Voice::SetEffectParameters.

CatatanXAudio2CreateReverb adalah fungsi sebaris dalam xaudio2fx.h yang memanggil sintaks CreateAudioReverb: '''

XAUDIO2FX_STDAPI CreateAudioReverb(Outptr IUnknown** ppApo); __inline HRESULT XAudio2CreateReverb(Outptr IUnknown** ppApo, UINT32 /Flags/ DEFAULT(0)) { return CreateAudioReverb(ppApo); }


</div>
<div> </div>
<h3><a id="Platform_Requirements"></a><a id="platform_requirements"></a><a id="PLATFORM_REQUIREMENTS"></a>Platform Requirements</h3>
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

## Requirements
| Requirement | Value |
| ---- |:---- |
| **Target Platform** | Windows |
| **Header** | xaudio2fx.h |
| **Library** | Xaudio2.lib |
| **DLL** | Windows.Media.Audio.dll |

## See also

<a href="/windows/desktop/xaudio2/how-to--create-an-effect-chain">How to: Create an Effect Chain</a>



<a href="/windows/desktop/api/xaudio2/nf-xaudio2-ixaudio2voice-seteffectparameters">IXAudio2Voice::SetEffectParameters</a>



<a href="/windows/desktop/api/xaudio2fx/ns-xaudio2fx-xaudio2fx_reverb_parameters">XAUDIO2FX_REVERB_PARAMETERS</a>



<a href="/windows/desktop/xaudio2/functions">XAudio2 Functions</a>