Metode IXAudio2Voice::GetChannelVolumes (xaudio2.h)

Mengembalikan tingkat volume untuk suara, per saluran.

Sintaks

\\ void GetChannelVolumes(
  [in]  UINT32 Channels,
  [out] float  *pVolumes
);

Parameter

[in] Channels

Mengonfirmasi jumlah saluran suara.

[out] pVolumes

Mengembalikan tingkat volume saat ini dari setiap saluran dalam suara. Array harus memiliki setidaknya elemen Channels . Lihat Keterangan untuk informasi selengkapnya tentang tingkat volume.

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Pengaturan ini diterapkan setelah rantai efek diterapkan. Metode ini hanya berlaku untuk suara sumber dan submix, karena suara master tidak menentukan volume per saluran.

Tingkat volume dinyatakan sebagai pengali ampli titik mengambang antara -2²⁴ hingga 2²⁴, dengan perolehan maksimum 144,5 dB. Volume 1 berarti tidak ada redaman atau perolehan, 0 berarti keheningan, dan tingkat negatif dapat digunakan untuk mengembalikan fase audio. Lihat Volume XAudio2 dan Kontrol Pitch untuk informasi tambahan tentang kontrol volume.

CatatanGetChannelVolumes selalu mengembalikan tingkat volume yang terakhir ditetapkan oleh IXAudio2Voice::SetChannelVolumes. Namun, nilai-nilai tersebut mungkin belum benar-benar berlaku: nilai tersebut hanya berlaku saat mesin audio berjalan setelah panggilan IXAudio2Voice::SetChannelVolumes (atau setelah panggilan IXAudio2::CommitChanges yang sesuai, jika IXAudio2Voice::SetChannelVolumes 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

Lihat juga

IXAudio2Voice