Metode IXAudio2Voice::SetChannelVolumes (xaudio2.h)

Artikel
03/04/2024

Mengatur tingkat volume untuk suara, per saluran.

Sintaks

\\HRESULT SetChannelVolumes(
  [in] UINT32      Channels,
  [in] const float *pVolumes,
  [in] UINT32      OperationSet
);

Parameter

[in] Channels

Jumlah saluran dalam suara.

[in] pVolumes

Array yang berisi volume baru setiap saluran dalam suara. Array harus memiliki elemen Channels . Lihat Keterangan untuk informasi selengkapnya tentang tingkat volume.

[in] OperationSet

Mengidentifikasi panggilan ini sebagai bagian dari batch yang ditangguhkan. Lihat gambaran umum XAudio2 Operation Sets untuk informasi selengkapnya.

Nilai kembali

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

Keterangan

SetChannelVolumes mengontrol tingkat output per saluran suara dan diterapkan tepat setelah SRC akhir suara dan sebelum dikirim.

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 -XAUDIO2_MAX_VOLUME_LEVEL dan XAUDIO2_MAX_VOLUME_LEVEL (-2²⁴ hingga 2²⁴), dengan perolehan maksimum 144,5 dB. Volume 1 berarti tidak ada redaman atau perolehan dan 0 berarti keheningan. Tingkat negatif dapat digunakan untuk menginversi fase audio. Lihat Volume XAudio2 dan Kontrol Pitch untuk informasi tambahan tentang kontrol volume.

CatatanIXAudio2Voice::GetChannelVolumes 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

Cara: Mengubah Volume Suara

IXAudio2Voice

Bagikan melalui