Bagikan melalui

Fungsi XAudio2CreateVolumeMeter (xaudio2fx.h)

  • Artikel

Membuat objek pemrosesan audio meter volume (APO) baru dan mengembalikan penunjuk ke objek tersebut.

Sintaks

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

Parameter

[in, out] ppApo

Berisi APO pengukur volume 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

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

Windows
Karena XAudio2CreateVolumeMeter memanggil CoCreateInstance di Windows, aplikasi harus memanggil metode CoInitializeEx sebelum memanggil XAudio2CreateVolumeMeter. XAudio2Create memiliki persyaratan yang sama, yang berarti CoInitializeEx biasanya akan dipanggil jauh sebelum XAudio2CreateVolumeMeter 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 * pVolumeMeterAPO;
XAudio2CreateVolumeMeter(&pVolumeMeterAPO);
 

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

class __declspec(uuid("4FC3B166-972A-40CF-BC37-7DB03DB2FBA3")) AudioVolumeMeter;

XAudio2CreateVolumeMeter mengembalikan objek ini sebagai penunjuk ke pointer 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.

Pengukur volume menggunakan struktur parameter XAUDIO2FX_VOLUMEMETER_LEVELS yang Anda akses melalui metode IXAudio2Voice::GetEffectParameters saat XAPO terikat ke grafik audio.

CatatanXAudio2CreateVolumeMeter adalah fungsi sebaris dalam xaudio2fx.h yang memanggil sintaks CreateAudioVolumeMeter: '''

XAUDIO2FX_STDAPI CreateAudioVolumeMeter(Outptr IUnknown** ppApo); __inline HRESULT XAudio2CreateVolumeMeter(Outptr IUnknown** ppApo, UINT32 /Flags/ DEFAULT(0)) { return CreateAudioVolumeMeter(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 |

## 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_volumemeter_levels">XAUDIO2FX_VOLUMEMETER_LEVELS</a>



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